Comandi semplici¶

Un comando semplice è una sequenza opzionale di assegnamenti di variabile seguita da parole, separate da blank, e ridirezioni, e terminata da un operatore di controllo. La prima parola specifica il comando che deve essere eseguito, ed è passata come argomento zero. Le rimanenti parole sono passate come argomenti al comando invocato.

Il valore di ritorno di un comando semplice è il suo stato di uscita, o 128+n se il comando è fatto terminare da un segnale R n .

Pipeline¶

Una pipeline è una sequenza di uno o più comandi separati dal carattere |. Il formato per una pipeline è:

Lo standard output di comando è connesso attraverso una pipe allo standard input di R comando2 . Questa connessione è effettuata prima di qualsiasi ridirezione specificata dal comando (si veda RIDIREZIONE più avanti).

Lo stato di ritorno di una pipeline è lo stato d'uscita dell'ultimo comando, a meno che l'opzione pipefail non sia abilitata. Se pipefail è abilitata, lo stato di ritorno della pipeline è il valore dell'ultimo comando (il più a destra) che esce con uno stato diverso da zero o zero se tutti i comandi escono con successo. Se la parola riservata ! precede una pipeline, lo stato d'uscita di quella pipeline è la negazione logica dello stato d'uscita come sopra descritto. La shell aspetta che tutti i comandi nella pipeline terminino prima di ritornare un valore.

Se la parola riservata time precede una pipeline, quando la pipeline termina vengono notificati i tempi impiegati dall'utente e dal sistema per la sua esecuzione. L'opzione -p cambia il formato di output con quello specificato da POSIX. La variabile TIMEFORMAT può essere impostata a una stringa di formato che specifica come le informazioni sui tempi dovranno essere mostrate; si veda la descrizione di TIMEFORMAT sotto Variabili di shell più avanti.

Ogni comando in una pipeline è eseguito come un processo separato (cioè in una subshell).

Liste¶

Una lista è una sequenza di una o più pipeline separate da uno degli operatori ;, &, &&, o ⎪⎪, e facoltativamente fatta terminare da uno fra ;, &, o <newline>.

Di questi operatori di lista, && e ⎪⎪ hanno uguale precedenza, seguiti da ; e &, che hanno uguale precedenza.

Per delimitare dei comandi può essere usata in una lista una sequenza di uno o più newline al posto di un punto e virgola.

Se un comando è terminato dall'operatore di controllo &, la shell esegue il comando in background in una subshell. La shell non aspetta che il comando finisca, e lo stato di ritorno è 0. I comandi separati da un ; sono eseguiti sequenzialmente; la shell aspetta che ogni comando, in sequenza, termini. Lo stato di ritorno è lo stato d'uscita dell'ultimo comando eseguito.

Gli operatori di controllo && e ⎪⎪ denotano liste AND e liste OR, rispettivamente. Una lista AND ha la forma

comando2 è eseguito se, e solo se, comando1 ritorna uno stato d'uscita di zero.

Una lista OR ha la forma

comando2 è eseguito se e solo se comando1 ritorna uno stato d'uscita diverso da zero. Lo stato di ritorno di liste AND e OR è lo stato d'uscita dell'ultimo comando eseguito nella lista.

Comandi composti¶

Un comando composto è uno dei seguenti:

(lista)

lista è eseguita in un ambiente di subshell (si veda AMBIENTE DI ESECUZIONE DEI COMANDI più avanti). Assegnamenti di variabile e comandi incorporati che influenzano l'ambiente della shell non hanno effetto dopo che il comando è completato. Lo stato di ritorno è lo stato d'uscita di lista.

{ lista; }

lista è semplicemente eseguita nell'ambiente di shell corrente. lista deve essere fatta terminare con un newline o un punto e virgola. Questo è conosciuto come group command. Lo stato di ritorno è lo stato d'uscita di lista. Da notare che diversamente dai metacaratteri ( e ), { e } sono parole riservate e devono essere usati quando una parola riservata è ammissibile. Poiché esse non causano una divisione delle parole, devono essere separate da lista con uno spazio.

((espressione))

L'espressione è valutata in accordo con le regole descritte più avanti sotto VALUTAZIONE ARITMETICA. Se il valore dell'espressione è diverso da zero, lo stato di ritorno è 0; altrimenti lo stato di ritorno è 1. Questo è esattamente equivalente a let "espressione".

[[ espressione ]]

Ritorna uno stato di 0 o 1 a seconda della valutazione della espressione condizionale espressione. Le espressioni sono composte dalle primitive descritte più avanti sotto ESPRESSIONI CONDIZIONALI. La suddivisione in parole e l'espansione del nome di percorso non sono effettuate sulle parole fra la [[ e ]]; espansione della tilde, espansione di parametro e di variabile, espansione aritmetica, sostituzione di comando, sostituzione di processo, e rimozione degli apici vengono effettuate. Gli operatori condizionali come -f devono essere senza apici per essere riconosciuti come primitive.

Quando vengono usati gli operatori == e !=, la stringa alla destra dell'operatore è considerato un modello ed è confrontata in accordo con le regole descritte più avanti sotto Modelli di ricerca. Se l'opzione di shell nocasematch è abilitata, il confronto è effettuato senza distinzione fra maiuscole e minuscole nei caratteri alfabetici. Il valore di ritorno è 0 se la stringa corrisponde (==) o non corrisponde (!=) al modello, e 1 negli altri casi. Ogni parte del modello può essere quotato per forzarlo a essere individuato come una stringa.

Un ulteriore operatore binario, =~, è disponibile con la stessa precedenza di == e !=. Quando viene usato, la stringa alla destra dell'operatore è considerata un'espressione regolare estesa e confrontata come tale (come in regex(3)). Il valore di ritorno è 0 se la stringa corrisponde al modello, e 1 negli altri casi. Se l'espressione regolare è sintatticamente scorretta, il valore di ritorno dell'espressione condizionale è 2. Se l'opzione di shell nocasematch è abilitata, il confronto è effettuato senza distinguere le maiuscole dalle minuscole nei caratteri alfabetici. Substringhe individuate tramite subespressioni fra parentesi all'interno dell'espressione regolare sono salvate nella variabile array BASH_REMATCH. L'elemento di BASH_REMATCH con indice 0 è la porzione della stringa corrispondente all'intera espressione regolare. L'elemento di BASH_REMATCH con indice n è la porzione della stringa corrispondente alla subespressione fra parentesi nth.

Le espressioni possono essere combinate usando i seguenti operatori, elencati in ordine inverso di precedenza:

for nome [ in parola; ] do lista ; done

La lista di parole che seguono in è espansa, generando una lista di elementi. La variabile nome è impostata, di volta in volta, a ciascun elemento di questa lista e lista è eseguita ogni volta. Se la in parola è omessa, il comando for esegue lista una volta per ogni parametro posizionale esistente (si veda PARAMETRI più avanti). Lo stato di ritorno è lo stato d'uscita dell'ultimo comando eseguito. Se l'espansione degli elementi che seguono in risultano in una lista vuota, non è eseguito alcun comando, e lo stato di ritorno è 0.

for (( expr1 ; expr2 ; expr3 )) ; do lista ; done

Prima viene valutata l'espressione aritmetica expr1 in accordo con le regole descritte più avanti sotto VALUTAZIONE ARITMETICA. Viene quindi valutata ripetutamente l'espressione aritmetica expr2 finché non assume il valore zero. Ogni volta che expr2 è diverso da zero, lista viene eseguita e l'espressione aritmetica expr3 viene valutata. Se qualche espressione è omessa, si suppone che abbia il valore 1. Il valore di ritorno è lo stato d'uscita dell'ultimo comando in lista che è eseguito, o falso se una qualsiasi delle espressioni non è valida.

select nome [ in parola; ] do lista ; done

La lista di parole che segue in è espansa, generando una lista di elementi. L'insieme delle parole espanse è stampato sullo standard error, ognuna preceduta da un numero. Se la in parola è omessa, sono stampati i parametri posizionali (si veda PARAMETRI più avanti). È poi mostrato il prompt PS3 ed è letta una riga dallo standard input. Se la riga è contrassegnata da un numero corrispondente a una delle parole mostrate, allora il valore di nome è impostato a quella parola. Se la riga è vuota, le parole e il prompt sono mostrati di nuovo. Se viene immesso EOF [CTRL-D], il comando termina. Qualsiasi altro valore letto fa sì che nome sia impostato al valore nullo. La riga letta è salvata nella variabile REPLY. La lista è eseguita dopo ciascuna selezione fino a che non sia eseguito un comando break . Lo stato d'uscita di select è lo stato d'uscita dell'ultimo comando eseguito in R lista , o zero se nessun comando è stato eseguito.

case parola in [ [(] modello [ | modello ] ... ) lista ;; ] ... esac

Un comando case prima espande parola, e prova a confrontarla, di volta in volta, con ognuno dei modelli, usando le stesse regole di confronto dell'espansione di percorso (si veda Espansione di percorso più avanti). La parola è espansa usando espansione della tilde, espansione di parametro e di variabile, sostituzione aritmetica, sostituzione di comando, sostituzione di processo e rimozione dei simboli di quotatura. Ogni modello esaminato è espanso usando espansione della tilde, espansione di parametro e di variabile, sostituzione aritmetica, sostituzione di comando e sostituzione di processo. Se l'opzione di shell nocasematch è abilitata, il confronto è effettuato senza distinzione fra maiuscole e minuscole nei caratteri alfabetici. Quando viene trovata una corrispondenza, viene eseguita la lista a essa abbinata. Dopo il primo confronto riuscito, non ne viene tentato nessun altro. Lo stato d'uscita è 0 se nessun modello corrisponde. Altrimenti, esso è lo stato d'uscita dell'ultimo comando eseguito in lista.

if lista then lista [ elif lista then lista ] ... [ else lista ] fi

La lista if è eseguita. Se il suo stato d'uscita è 0, è eseguita la lista dopo then. Altrimenti, è eseguita a turno ciascuna lista dopo elif, e se il suo stato d'uscita è 0, è eseguita la corrispondente lista dopo then e il comando termina. Altrimenti, se presente, è eseguita, la lista dopo else. Lo stato d'uscita è lo stato d'uscita dell'ultimo comando eseguito, o zero se nessuna delle condizioni considerate è risultata essere vera.

while lista do lista done

until lista do lista done

Il comando while esegue ripetutamente la lista dopo do finché l'ultimo comando in lista ritorna uno stato di uscita di zero. Il comando until è identico al comando while, con la sola differenza che il risultato del test è negato; la lista do è eseguita finché l'ultimo comando in lista ritorna uno stato d'uscita diverso da zero. Lo stato d'uscita dei comandi while e until è lo stato d'uscita dell'ultimo comando eseguito nella lista do o zero se non ne è stato eseguito alcuno.

Definizioni della funzione di shell¶

Una funzione di shell è un oggetto che viene chiamato come un comando semplice ed esegue un comando composto con una nuova serie di parametri posizionali. Le funzioni di shell sono dichiarate in questo modo:

[ function ] nome () comando-composto [ridirezione]

Qui sopra si definisce una funzione chiamata nome. La parola riservata function è opzionale. Se la parola riservata function è fornita, le parentesi sono opzionali. Il corpo della funzione è il comando composto comando-composto (si veda Comandi composti sopra). Questo comando è usualmente una lista di comandi fra { e }, ma potrebbe essere qualsiasi comando elencato in precedenza, sotto Comandi composti. comando-composto è eseguito ogni volta che nome è specificato come nome di un comando semplice. Ogni ridirezione (si veda RIDIREZIONI più avanti) specificata quando una funzione è definita viene effettuata quando quella funzione viene eseguita. Lo stato d'uscita di una definizione di funzione è 0 tranne quando si verifica un errore di sintassi o una funzione in sola lettura con lo stesso nome è già esistente. Quando eseguita, lo stato d'uscita di una funzione è lo stato d'uscita dell'ultimo comando eseguito nel corpo. (si veda FUNZIONI più avanti).

Parametri posizionali¶

Un parametro posizionale è un parametro il cui nome è indicato da una o più cifre, diverse dalla singola cifra 0. I parametri posizionali sono assegnati dagli argomenti della shell quando questa è invocata, e possono essere riassegnati usando il comando incorporato set . I parametri posizionali non possono essere assegnati con istruzioni di assegnamento. I parametri posizionali sono temporaneamente sostituiti quando è eseguita una funzione di shell (si veda FUNZIONI più avanti).

Quando si espande un parametro posizionale composto da più di una sola cifra, esso deve essere racchiuso tra parentesi graffe (si veda ESPANSIONE più avanti).

Parametri speciali¶

La shell tratta molti parametri in modo speciale. Questi parametri possono solo essere referenziati; la loro modifica non è permessa.

*

Si espande nei parametri posizionali, a partire dal primo. Quando l'espansione avviene tra virgolette, si espande in una singola parola contenente il valore di ciascun parametro separato dagli altri dal primo carattere della variabile speciale IFS. Cioè, ``$*'' è equivalente a ``$1c$2c...'', dove c è il primo carattere del valore della variabile IFS. Se IFS viene annullato, i parametri sono separati da spazi. Se IFS è nulla, i parametri sono uniti senza alcun separatore.

@

Si espande nei parametri posizionali, a partire dal primo. Quando l'espansione avviene tra virgolette, ogni parametro si espande in una parola separata. Cioè, "$@" è equivalente a "$1" "$2" ... Se l'espansione fra virgolette avviene all'interno di una parola, l'espansione del primo parametro è unita con la parte iniziale della parola originale, e l'espansione dell'ultimo parametro è unita con la parte finale della parola originale. Quando non vi è alcun parametro posizionale, "$@" e $@ si espandono come stringa nulla (cioè, sono rimossi).

#

Si espande nel numero di parametri posizionali espresso come numero decimale.

?

Si espande nello stato della pipeline eseguita più recentemente senza rilasciare il controllo del terminale.

-

Si espande nei flag di opzione correnti come specificato in base alla chiamata, dal comando incorporato set, o in quelli impostati dalla shell stessa (come l'opzione -i ).

$

Si espande nell'ID di processo della shell. In una subshell (), si espande nell'ID di processo della shell corrente, non in quello della subshell.

!

Si espande nell'ID di processo del comando in background (asincrono) più recentemente eseguito.

0

Si espande nel nome della shell o script di shell. Questo è impostato alla inizializzazione della shell. Se bash è chiamata con un file di comandi, $0 è impostato al nome di quel file. Se bash è avviata con l'opzione -c, allora $0 è impostato al primo argomento dopo la stringa che deve essere eseguita, se presente. Altrimenti, è impostato al percorso usato per chiamare bash, come dato dall'argomento zero.

_

All'avvio della shell, impostato al nome di percorso assoluto usato per invocare la shell o lo script di shell che è eseguito come passato nell'ambiente o nella lista di argomenti. Successivamente, si espande nell'ultimo argomento del precedente comando, dopo l'espansione. È anche impostato al nome completo usato per invocare ogni comando eseguito e messo nell'ambiente esportato verso quel comando. Mentre si controlla la posta, questo parametro contiene il nome del file del messaggio attualmente in esame.

Variabili di shell¶

Le seguenti variabili sono impostate dalla shell:

BASH

Si espande al nome completo usato per chiamare questa istanza di bash.

BASH_ARGC

Una variabile di array i cui valori sono il numero di parametri in ogni frame del corrente stack delle chiamate di esecuzione di bash. Il numero di parametri della subroutine corrente (funzione di shell o script eseguito con . o source) è in cima allo stack. Quando viene eseguita una subroutine, il numero di parametri passati è messo in cima a BASH_ARGC. La shell imposta BASH_ARGC solo quando è in modalità estesa di debugging (si veda la descrizione dell'opzione extdebug per il comando incorporato shopt più avanti)

BASH_ARGV

Una variabile di array contenente tutti i parametri nel corrente stack delle chiamate di esecuzione di bash. Il parametro finale dell'ultima chiamata di subroutine è in cima allo stack; il primo parametro della chiamata iniziale è in fondo. Quando una subroutine viene eseguita, i parametri forniti sono messi in cima a BASH_ARGV. La shell imposta BASH_ARGV solo quando è in modalità estesa di debugging (si veda la descrizione dell'opzione extdebug al comando incorporato shopt più avanti)

BASH_COMMAND

Il comando attualmente in esecuzione o in procinto di essere eseguito, a meno che la shell non stia eseguendo un comando come risultato di un'intercettazione di segnale (trap), nel qual caso è il comando in esecuzione al momento dell'intercettazione.

BASH_EXECUTION_STRING

L'argomento per il comando all'invocazione dell'opzione -c.

BASH_LINENO

Una variabile array i cui elementi sono i numeri di riga nei file di origine corrispondenti a ciascun elemento di FUNCNAME. ${BASH_LINENO[$i]} è il numero di riga nel file di origine dove ${FUNCNAME[$ifP]} è stato chiamato. Il nome del file di origine corrispondente è ${BASH_SOURCE[$i]}. Usare LINENO per ottenere il numero di riga corrente.

BASH_REMATCH

Una variabile array i cui elementi sono assegnati dall'operatore binario =~ al comando condizionale [[. L'elemento con indice 0 è la porzione della stringa che corrisponde all'intera espressione regolare. L'elemento con indice n è la porzione della stringa che corrisponde alla n-sima subespressione fra parentesi. La variabile è in sola lettura.

BASH_SOURCE

Una variabile array i cui elementi sono i nomi dei file da cui provengono gli elementi nella variabile array FUNCNAME.

BASH_SUBSHELL

Incrementato di uno ogni volta che una subshell o un ambiente di subshell è stato creato dalla shell originale. Il valore iniziale è 0.

BASH_VERSINFO

Una variabile array in sola lettura i cui elementi danno informazioni sulla versione di quest'istanza di bash. I valori assegnati ai membri dell'array sono come segue:

BASH_VERSION

Si espande in una stringa che descrive la versione di questa istanza di bash.

COMP_CWORD

Un indice in ${COMP_WORDS} della parola contenente la posizione corrente del cursore. Questa variabile è disponibile solo nelle funzioni di shell invocate dalle risorse di completamento programmabile (si veda Completamento programmabile più avanti).

COMP_LINE

La riga di comando corrente. Questa variabile è disponibile solo nelle funzioni di shell e nei comandi esterni invocati dai servizi di completamento programmabile (si veda Completamento programmabile più avanti).

COMP_POINT

L'indice della posizione corrente del cursore relativa all'inizio del comando corrente. Se la posizione corrente del cursore è alla fine del comando corrente, il valore di questa variabile è uguale a ${#COMP_LINE}. Questa variabile è disponibile solo nelle funzioni di shell e comandi esterni invocati dai servizi di completamento programmabile (si veda Completamento programmabile più avanti).

COMP_WORDBREAKS

L'insieme dei caratteri che la libreria Readline tratta come separatori di parola nell'effettuare il completamento di parola. Se COMP_WORDBREAKS viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

COMP_WORDS

Una variabile array (si veda Array più avanti) che è composta dalle singole parole nella riga di comando corrente. Le parole sono divise anche dai metacaratteri della shell poiché l'analizzatore della shell li considererebbe a parte. Questa variabile è disponibile solo nelle funzioni di shell e comandi esterni invocati dai servizi di completamento programmabile (si veda Programmable Completion più avanti).

DIRSTACK

Una variabile array (si veda Array più avanti) che contiene il contenuto corrente dello stack delle directory. Le directory appaiono nello stack nell'ordine in cui sono mostrate dal comando incorporato dirs . L'assegnamento agli elementi di questa variabile array può essere usato per modificare le directory già nello stack, ma i comandi incorporati pushd e popd devono essere usati per aggiungere e rimuovere directory. L'assegnamento a questa variabile non cambia la directory corrente. Se DIRSTACK viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

EUID

Espande all'ID-utente effettivo dell'utente corrente, inizializzata all'avvio della shell. Questa variabile è in sola lettura.

FUNCNAME

Una variabile array contenente i nomi di tutte le funzioni di shell attualmente nello stack delle chiamate di esecuzione. L'elemento con indice 0 è il nome della funzione di shell attualmente in esecuzione. L'elemento più in basso di tutti è "main". Questa variabile esiste solo quando è in esecuzione una funzione di shell. Assegnamenti a FUNCNAME non hanno alcun effetto e ritornano uno stato di errore. Se FUNCNAME viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

GROUPS

Una variabile array contenente l'elenco dei gruppi dei quali è membro l'utente corrente. Assegnamenti a GROUPS non hanno alcun effetto e ritornano uno stato di errore. Se GROUPS viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

HISTCMD

Il numero di cronologia, o indice nella lista della cronologia, del comando corrente. Se HISTCMD viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

HOSTNAME

Automaticamente impostata al nome dell'host corrente.

HOSTTYPE

Automaticamente impostata a una stringa che univocamente descrive il tipo di macchina su cui bash è in esecuzione. Il valore di default è dipendente dal sistema.

LINENO

Ogni volta che questo parametro è referenziato, la shell gli assegna un numero decimale che rappresenta il numero di sequenza della riga corrente (partendo da 1) all'interno di uno script o funzione. Quando non in uno script o funzione, non è garantito che il valore restituito sia significativo. Se LINENO viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

MACHTYPE

Automaticamente impostata a una stringa che descrive completamente il tipo di sistema sul quale bash è in esecuzione, nel formato standard GNU cpu-company-system. Il valore di default è dipendente dal sistema.

OLDPWD

La precedente directory di lavoro come impostata dal comando cd.

OPTARG

Il valore dell'ultimo argomento opzione elaborato dal comando incorporato getopts (si veda COMANDI INCORPORATI DELLA SHELL più avanti).

OPTIND

L'indice del prossimo argomento che dev'essere elaborato dal comando incorporato getopts (si veda COMANDI INCORPORATI DELLA SHELL più avanti).

OSTYPE

Automaticamente impostata a una stringa che descrive il sistema operativo su cui bash è in esecuzione. Il valore di default è dipendente dal sistema.

PIPESTATUS

Una variabile array (si veda Array più avanti) contenente un elenco di valori di stato d'uscita dai processi nelle pipeline eseguite più recentemente in primo piano [cioè senza rilasciare il controllo del terminale] (può contenere anche un solo comando).

PPID

L'ID di processo del genitore della shell. Questa variabile è in sola lettura.

PWD

La directory di lavoro corrente come impostata dal comando cd.

RANDOM

Ogni volta che questo parametro è referenziato, viene generato un numero intero casuale fra 0 e 32767. La sequenza di numeri casuali può essere inizializzata assegnando un valore a RANDOM. Se RANDOM viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

REPLY

Impostata alla riga di input letta dal comando incorporato read quando nessun argomento è specificato.

SECONDS

Ogni volta che questo parametro è referenziato, viene restituito il numero di secondi trascorsi dalla chiamata della shell. Se un valore è assegnato a SECONDS, il valore restituito in base ai riferimenti successivi è il numero di secondi trascorsi dall'assegnamento più il valore assegnato. Se SECONDS viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

SHELLOPTS

Una lista, separata da due punti, di opzioni di shell abilitate. Ogni parola nella lista è un argomento valido per l'opzione -o al comando incorporato set (si veda COMANDI INCORPORATI DI SHELL più avanti). Le opzioni che appaiono in SHELLOPTS sono quelle indicate come on da set -o. Se questa variabile è nell'ambiente quando bash viene avviata, ogni opzione di shell nella lista viene abilitata prima di leggere un qualsiasi file di avvio. Questa variabile è in sola lettura.

SHLVL

È incrementato di uno ogni volta che una istanza di bash viene avviata.

UID

Si espande all'ID-utente dell'utente corrente, inizializzato all'avvio della shell. Questa variabile è in sola lettura.

Le seguenti variabili sono usate dalla shell. In alcuni casi, bash assegna un valore di default a una variabile; questi casi sono elencati più avanti.

BASH_ENV

Se questo parametro è impostato quando bash sta eseguendo uno script di shell, il suo valore è interpretato come un nome di file contenente comandi per inizializzare la shell, come in R ~/.bashrc . Il valore di BASH_ENV è soggetto a espansione di parametro, sostituzione di comando ed espansione aritmetica prima di essere interpretato come un nome di file. PATH non è usato per cercare il nome di file risultante.

CDPATH

Il percorso di ricerca per il comando cd. Questo è un elenco di directory, separate da due punti, nelle quali la shell cerca le directory di destinazione specificate dal comando cd. Un valore di esempio è ".:~:/usr".

COLUMNS

Usato dal comando incorporato select per determinare il numero di colonne del terminale nella stampa delle liste di selezione. Automaticamente re-impostata al ricevimento di un segnale SIGWINCH.

COMPREPLY

Una variabile array dalla quale bash legge i possibili completamenti generati da una funzione di shell invocata dal servizio di completamento programmabile (si veda Completamento programmabile più avanti).

EMACS

Se bash trova questa variabile d'ambiente alla partenza della shell col valore "t", presume che la shell sia in esecuzione in un buffer di shell emacs e disabilita la modifica della riga.

FCEDIT

L'editor di default per il comando incorporato fc.

FIGNORE

Una lista di suffissi, separati da due punti, da ignorare quando si effettua il completamento del nome di file (si veda READLINE più avanti). Un nome di file il cui suffisso corrisponde a una delle voci in FIGNORE è escluso dalla lista dei nomi di file individuati. Un valore di esempio è ".o:~".

GLOBIGNORE

Una lista di modelli, separati da due punti, che definiscono l'insieme dei nomi di file che l'espansione del nome di percorso deve ignorare. Se un nome di file individuato da un modello di espansione del percorso corrisponde anche a uno dei modelli in GLOBIGNORE, viene rimosso dalla lista dei nomi da individuare.

HISTCONTROL

Una lista di valori, separati da due punti, che controllano come i comandi vengono salvati nell'elenco della cronologia. Se la lista di valori include R ignorespace , le righe che iniziano con un carattere di spazio non vengono salvate nell'elenco della cronologia. Un valore di ignoredups fa sì che non venga salvata ogni riga uguale all'elemento precedente della cronologia. Un valore di ignoreboth è la combinazione di ignorespace e ignoredups. Un valore di R erasedups fa sì che tutte le righe uguali alla riga corrente vengano rimosse dall'elenco della cronologia prima che la riga venga salvata. Qualsiasi valore che non è nella lista di cui sopra è ignorato. Se HISTCONTROL viene annullato o non include un valore valido, tutte le righe lette dall'analizzatore sintattico della shell sono salvate nell'elenco della cronologia, a meno che non sia stato specificato HISTIGNORE. La seconda riga e le successive di un comando composto multiriga non vengono controllate, e sono aggiunte alla cronologia indipendentemente dal valore di HISTCONTROL.

HISTFILE

Il nome del file nel quale è salvata la cronologia dei comandi (si veda CRONOLOGIA più avanti). Il valore predeterminato è ~/.bash_history. Se è annullato la cronologia dei comandi non è salvata al termine di una shell interattiva.

HISTFILESIZE

Il numero massimo di righe contenute nel file della cronologia. Quando a questa variabile è assegnato un valore, il file della cronologia è accorciato, se necessario, rimuovendo le voci più vecchie, per contenere non più di quel numero di righe. Il valore di default è 500. Il file della cronologia è inoltre troncato a questa dimensione dopo la scrittura al termine di una shell interattiva.

HISTIGNORE

Una lista di modelli separati da due punti usata per decidere quali righe di comando devono essere salvate nell'elenco della cronologia. Ogni modello comincia all'inizio della riga e deve corrispondere alla riga completa (nessun `*' implicito è aggiunto). Ogni modello è confrontato con la riga dopo che i controlli specificati da HISTCONTROL sono stati applicati. In aggiunta ai normali modelli di shell che confrontano caratteri, `&' designa la linea precedente della cronologia. `&' può essere protetto usando un backslash; il backslash è rimosso prima di eseguire un confronto. La seconda riga e le successive di un comando composto multiriga non vengono controllate, e sono aggiunte alla cronologia indipendentemente dal valore di HISTIGNORE.

HISTSIZE

Il numero di comandi da memorizzare nella cronologia dei comandi (si veda CRONOLOGIA più avanti). Il valore di default è 500.

HISTTIMEFORMAT

Se questa variabile è impostata e non nulla, il suo valore è usato come stringa di formato per strftime(3) per stampare l'informazione "data e ora" associata a ogni voce della cronologia mostrata dal comando incorporato history. Se questa variabile è impostata, data e ora verranno scritte nel file della cronologia in modo da essere disponibili anche in successive sessioni della shell.

HOME

La home directory dell'utente corrente; l'argomento di default per il comando incorporato cd. Il valore di questa variabile è anche usata quando si effettua l'espansione della tilde.

HOSTFILE

Contiene il nome di un file nello stesso formato di che dovrà essere letto quando la shell ha bisogno di completare un nome di host. La lista dei possibili completamenti di nome di host può essere cambiata mentre la shell è in esecuzione; alla prossima occasione in cui si tenta il completamento del nome di host dopo che è cambiato il valore, bash aggiunge il contenuto del nuovo file alla lista esistente. Se HOSTFILE è impostato ma non ha alcun valore, bash tenta di leggere per ottenere la lista dei possibili completamenti del nome di host. Quando HOSTFILE viene annullato, la lista dei nomi di host viene pure annullata.

IFS

L' Internal Field Separator (separatore di campo interno) è usato per la suddivisione in parole dopo l'espansione e per dividere le righe in parole quando si esegue il comando incorporato read. Il valore di default è ``<space><tab><newline>''.

IGNOREEOF

Controlla l'azione della shell al ricevimento di un carattere EOF come unico contenuto di una riga di input. Se impostato, il valore è il numero di caratteri EOF consecutivi da battere come primo carattere su una riga di input prima che bash esca. Se la variabile esiste ma non ha un valore numerico, o non ha alcun valore, il valore di default è 10. Se non esiste, EOF indica la fine dell'input per la shell.

INPUTRC

Il nome di file per il file di avvio di readline che prevale sul valore di default che è (si veda READLINE più avanti).

LANG

Usata per determinare la categoria di localizzazione per qualsiasi categoria non specificatamente specificata da una delle variabili che iniziano con LC_.

LC_ALL

Questa variabile prevale sul valore di LANG e su qualsiasi altra variabile LC_ che specifichi una categoria di localizzazione.

LC_COLLATE

Questa variabile determina l'ordine di collazione usato quando vengono ordinati i risultati dell'espansione di nome di percorso, e determina il comportamento di espressioni di intervallo, classi di equivalenza e sequenze di ordinamento all'interno dell'espansione di nome di percorso e della corrispondenza tra stringhe.

LC_CTYPE

Questa variabile determina l'interpretazione di caratteri e il comportamento di classi di caratteri all'interno dell'espansione di nome di percorso e della corrispondenza tra stringhe.

LC_MESSAGES

Questa variabile determina la localizzazione usata per tradurre stringhe tra virgolette precedute da un $.

LC_NUMERIC

Questa variabile determina la categoria di localizzazione usata per la formattazione dei numeri.

LINES

Usato dal comando incorporato select per determinare il numero di linee del terminale nella stampa delle liste di selezione. Automaticamente re-impostata al ricevimento di un segnale SIGWINCH.

MAIL

Se questo parametro è impostato a un nome di file e la variabile MAILPATH non è impostata, bash informa l'utente dell'arrivo di posta nel file specificato.

MAILCHECK

Specifica la frequenza (in secondi) con cui bash controlla la posta. Il valore di default è 60 secondi. Quando è il momento di controllare la posta, la shell lo fa prima di mostrare il prompt primario. Se questa variabile non è impostata, o è impostata a un valore che non sia un numero maggiore o uguale a zero, la shell disabilita il controllo della posta.

MAILPATH

Una lista di nomi di file separati da due punti, da usare per il controllo della posta. Il messaggio che deve essere stampato all'arrivo dei messaggi in un particolare file può essere specificato separando il nome del file dal messaggio con un `?'. Quando viene usato nel testo del messaggio $_ è espanso al nome del file di posta corrente. Per esempio:

OPTERR

Se impostato al valore 1, bash mostra i messaggi di errore generati dal comando incorporato getopts (si veda COMANDI INCORPORATI DELLA SHELL più avanti). OPTERR è inizializzato ad 1 ogni volta che viene invocata la shell o viene eseguito uno script di shell.

PATH

Il percorso di ricerca dei comandi. È un elenco di directory separate da due punti, nelle quali la shell cerca i comandi (si veda ESECUZIONE DEI COMANDI più avanti). Un nome di directory di lunghezza zero (nulla) nel valore di PATH indica la directory corrente. Un nome di directory nullo può apparire come una serie di due punti adiacenti, o come due punti all'inizio o alla fine. Il percorso di default è dipendente dal sistema ed è impostato dall'amministratore che installa bash. Un valore frequente è ``/usr/gnu/bin:/usr/local/bin:/usr/ucb:/bin:/usr/bin''.

POSIXLY_CORRECT

Se questa variabile è presente nell'ambiente quando viene avviata bash, la shell entra in modalità posix prima di leggere i file di avvio, come se l'opzione di invocazione --posix fosse stata specificata. Se è impostata mentre la shell è in esecuzione, bash abilita la modalità posix, come se il comando set -o posix fosse stato eseguito.

PROMPT_COMMAND

Se impostato, il valore è eseguito ogni volta come un comando prima di scrivere il prompt primario.

PS1

Il valore di questo parametro è espanso (si veda STRINGHE DI PROMPT più avanti) e usato come stringa del prompt primario. Il valore di default è``\s-\v\$ ''.

PS2

Il valore di questo parametro è espanso allo stesso modo di PS1 ed è usato come stringa di prompt secondario. Il valore di default è ``> ''.

PS3

Il valore di questo parametro è usato come prompt per il comando select (si veda GRAMMATICA DELLA SHELL sopra).

PS4

Il valore di questo parametro è espanso allo stesso modo di PS1 ed il valore è stampato prima di ogni comando che bash mostra durante un trace di esecuzione. Il primo carattere di PS4 è replicato tante volte, quanto necessario, per indicare livelli multipli di indirezione. Il valore di default è ``+ ''.

SHELL

In questa variabile d'ambiente è contenuto il percorso completo della shell. Se non è impostata quando la shell viene avviata, bash le assegna il percorso completo della shell di login dell'utente corrente.

TIMEFORMAT

Il valore di questo parametro è usato come stringa di formato per specificare come dovrà essere mostrata l'informazione su data e ora per pipeline aventi come prefisso la parola riservata time Il carattere % introduce una sequenza di formattazione che è espansa a un valore di data e ora o ad altre informazioni. Le sequenze di formattazione e il loro significato sono i seguenti; le parentesi quadre denotano parti opzionali.

La parte opzionale p è una cifra che specifica la precisione, il numero di cifre frazionali dopo il separatore decimale. Un valore pari a 0 fa sì che nessun separatore decimale o frazione venga inserito nell'output. Possono essere specificate al massimo tre posizioni dopo il separatore decimale; valori di p maggiori di 3 sono cambiati a 3. Se p non è specificato è utilizzato il valore 3.

La parte opzionale l specifica un formato più lungo, inclusi i minuti, nella forma MMmSS.FFs. Il valore di p determina se la frazione è inclusa o meno.

Se questa variabile non è impostata, bash agisce come se avesse il valore $'\nreal\t%3lR\nuser\t%3lU\nsys%3lS'. Se il valore è nullo, non viene mostrata alcuna informazione di tempo. Una newline finale è aggiunta quando la stringa di formato è visualizzata.

TMOUT

Se impostato a un valore maggiore di zero, TMOUT è trattato come il tempo limite (timeout) di default per il comando incorporato read. Il comando select viene terminato se non riceve input dopo TMOUT secondi quando l'input è chiesto a un terminale. In una shell interattiva il valore è interpretato come il numero di secondi di attesa per l'input dopo l'emissione del prompt primario. Se l'input non arriva Bash termina dopo aver aspettato per quel numero di secondi.

TMPDIR

Se impostato, Bash usa il suo valore come nome della directory nella quale Bash crea file temporanei a uso della shell.

auto_resume

Questa variabile controlla il modo con cui la shell interagisce con l'utente e con il job-control. Se questa variabile è impostata, dei comandi semplici composti da una sola parola senza ridirezioni sono considerati come candidati per la ripresa di un job in esecuzione che sia stato sospeso. Non è possibile alcuna ambiguità; se vi è più di un job che comincia con la stringa digitata, è scelto il job su cui si è effettuato l'accesso più recentemente. Il nome di un job sospeso, in questo contesto, è la riga di comando usata per avviarlo. Se impostato al valore R exact , la stringa fornita deve essere esattamente uguale al nome di un job fermo; se impostato a R substring , la stringa fornita deve combaciare con una substringa del nome di un job sospeso. Il valore substring fornisce funzionalità analoghe all'identificatore del job %? (si veda JOB CONTROL più avanti). Se impostato a qualsiasi altro valore, la stringa fornita deve essere un prefisso del nome di un job sospeso; questo consente funzionalità analoghe all'identificatore di job %string

histchars

Sono i due o tre caratteri che controllano l'espansione della cronologia e la suddivisione in token (si veda ESPANSIONE DELLA CRONOLOGIA più avanti). Il primo carattere è il carattere di espansione della cronologia, il carattere che segnala l'inizio di una espansione della cronologia, normalmente `!'. Il secondo carattere è il carattere di sostituzione rapida, che è usato come scorciatoia per rieseguire il comando precedentemente inserito, sostituendo una stringa con un'altra nel comando. Il valore di default è `^'. Il terzo carattere, opzionale, è il carattere che indica che il resto della riga è un commento, quando è trovato come primo carattere di una parola, normalmente `#'. Il carattere di commento della cronologia fa sì che la sostituzione della cronologia venga saltata per le rimanenti parole sulla riga. Esso non fa necessariamente sì che l'analizzatore della shell tratti il resto della riga come un commento.

Array¶

Bash fornisce variabili array monodimensionali. Ogni variabile può essere usata come un array; il comando incorporato declare dichiara esplicitamente un array. Non c'è un limite massimo per la dimensione di un array, né alcuna richiesta che gli elementi siano indicizzati o assegnati in modo contiguo. Gli array sono indicizzati usando numeri interi e cominciano con l'indice zero.

Un array è creato automaticamente se a una variabile qualsiasi è assegnato un valore usando la sintassi nome[subscript]=valore. Il subscript viene trattato come un'espressione aritmetica che deve risultare un numero maggiore o uguale a zero. Per dichiarare esplicitamente un array, usare declare -a nome (si veda COMANDI INCORPORATI DI SHELL più avanti). È anche accettato declare -a nome[subscript] ; il subscript viene ignorato. Per una variabile array possono essere specificati degli attributi utilizzando i comandi incorporati declare e readonly . Ogni attributo si applica a tutti gli elementi di un array.

Agli elementi dell'array vengono assegnati valori usando assegnamenti composti della forma nome=(valore1 ... valoren), dove ogni valore è della forma [subscript]=stringa. È richiesto solo stringa. Se vengono fornite le parentesi opzionali e il subscript, l'elemento viene assegnato a quell'indice; altrimenti l'indice dell'elemento assegnato è l'ultimo indice già utilizzato aumentato di uno. L'indicizzazione parte da zero. Questa sintassi è accettata anche dal comando incorporato declare . Elementi singoli di un array possono essere assegnati con la sintassi nome[subscript]=valore introdotta più sopra.

Qualsiasi elemento di un array può essere referenziato con ${nome[subscript]}. Le parentesi sono richieste per evitare conflitti con l'espansione di percorso. Se subscript è @ o *, la parola espande a a tutti gli elementi di nome. Questi subscript differiscono solo quando la parola appare inclusa fra virgolette. Se la parola è quotata con virgolette, ${nome[*]} espande a una singola parola col valore di ogni elemento dell'array separato dal primo carattere della variabile speciale IFS , e ${nome[@]} espande ogni elemento di nome come una parola separata. Quando non c'è l'elemento di array, ${nome[@]} è espanso alla stringa nulla. Se l'espansione quotata con virgolette si trova dentro una parola, l'espansione del primo parametro è legato con la parte iniziale della parola originale, e l'espansione dell'ultimo parametro è legato con l'ultima parte della parola originale. Questo è analogo all'espansione dei parametri speciali * e @ (si veda Parametri speciali sopra). ${#nome[subscript]} espande alla lunghezza di ${nome[subscript]}. Se subscript è * o @, l'espansione è il numero di elementi dell'array. Referenziare una variabile array senza specificare un subscript equivale a referenziare il suo elemento zero.

Il comando incorporato unset è usato per annullare gli array. unset nome[subscript] annulla l'elemento di array a indice subscript. Bisogna stare attenti a evitare effetti collaterali indesiderati causati dalla generazione di un nome di file. unset nome, dove nome è un array, o unset nome[subscript], dove subscript è * o @, rimuove l'intero array.

Ciascuno dei comandi incorporati declare, local e readonly accetta un'opzione -a per specificare un array. Il comando incorporato read accetta un'opzione -a per assegnare a un array una lista di parole lette dallo standard input. I comandi incorporati set e declare mostrano i valori di array in modo che da essere riutilizzabili come assegnamenti.

Espansione delle parentesi graffe¶

Espansione delle parentesi graffe è un meccanismo con il quale possono essere generate stringhe arbitrarie. Questo meccanismo è simile all'espansione di percorso, ma non è necessario che i file il cui nome è generato esistano. I modelli cui si applica l'espansione delle parentesi graffe hanno la forma di un R preambolo opzionale, seguito da una serie di stringhe separate da virgola o una espressione di sequenza racchiusa fra parentesi graffe, seguite da un' R appendice opzionale. Il preambolo è preposto a ogni stringa contenuta dentro le parentesi graffe e l'appendice è poi appesa a ogni stringa risultante, espandendo da sinistra a destra.

Le espansioni delle parentesi graffe possono essere nidificate. Il risultato di ogni stringa espansa non viene ordinato; è conservato l'ordine da sinistra a destra. Per esempio, a{d,c,b}e si espande in `ade ace abe'.

Un'espressione di sequenza prende la forma {x..y}, dove x e y sono o numeri interi o caratteri singoli. Se si specificano numeri interi, l'espressione espande a ogni numero fra x e y, incluso. Se si specificano caratteri l'espressione espande a ogni carattere lessicograficamente compreso fra x e y, incluso. Da notare che entrambi x e y devono essere dello stesso tipo.

L'espansione delle parentesi graffe è effettuata prima di qualsiasi altra espansione, e qualunque carattere speciale per uso delle altre espansioni viene lasciato com'era nel risultato. Essa è strettamente testuale. Bash non applica alcuna interpretazione sintattica al contesto dell'espansione o al testo tra parentesi graffe.

Un'espansione delle parentesi graffe correttamente formata deve contenere una parentesi graffa di apertura e una di chiusura, non quotate, e almeno una virgola non quotata. Qualunque espansione delle parentesi graffe erroneamente formata è lasciata inalterata. Una { o , può essere quotata con un backslash per evitare che venga considerata parte di un'espressione fra parentesi graffe. Per evitare conflitti con l'espansione di parametro, la stringa ${ non dà luogo all'espansione delle parentesi graffe.

Questo costrutto è tipicamente usato come abbreviazione quando il prefisso comune delle stringhe da generare è più lungo che negli esempi sopra:

L'espansione delle parentesi graffe introduce una lieve incompatibilità con le versioni tradizionali di sh. sh non tratta le parentesi graffe aperte e chiuse, specialmente quando esse appaiono come parte di una parola, e le conserva in uscita. Bash rimuove le parentesi graffe dalle parole come consequenza dell'espansione delle parentesi graffe. Per esempio, una parola data a sh come file{1,2} appare identica nell'output. La stessa parola è data in output come file1 file2 dopo l'espansione operata da bash.

Se si desidera una stretta compatibilità con sh si avvia bash con l'opzione +B o si disabilita l'espansione delle parentesi graffe con l'opzione +B al comando set (si veda COMANDI INCORPORATI DELLA SHELL più avanti).

Espansione della tilde¶

Se una parola comincia con un carattere tilde (`~') non quotato, tutti i caratteri che precedono la prima barra [/] non quotata (o tutti i caratteri, se non vi è alcuna barra) sono considerati un prefisso tilde. Se nessuno dei caratteri nel prefisso tilde è quotato, i caratteri nel prefisso tilde che segue la tilde sono trattati come un possibile nome di login. Se questo nome di login è la stringa nulla, la tilde è sostituita con il valore del parametro HOME. Se HOME viene annullato, è invece sostituita la home directory dell'utente che sta eseguendo la shell. Altrimenti, il prefisso tilde è sostituito con la home directory associata al nome di login specificato.

Se il prefisso tilde è un `~+' il valore della variabile di shell PWD sostituisce il prefisso tilde. Se il prefisso tilde è un `~-', il valore della variabile di shell OLDPWD, se impostato, viene sostituito. Se il carattere che segue la tilde nel prefisso tilde è un numero N, con un prefisso opzionale `+' o `-', il prefisso tilde è sostituito dal corrispondente elemento dallo stack di directory, come dovrebbe essere mostrato dal comando incorporato dirs invocato col prefisso tilde come argomento. Se il carattere che segue la tilde nel prefisso tilde è un numero non preceduto da un segno `+' o `-', viene assunto `+'

Se il nome di login non è valido o l'espansione della tilde non ha successo, la parola rimane invariata.

Ogni assegnamento di variabile è controllato per prefissi tilde non quotati che seguono immediatamente un : o il primo =. In questi casi viene effettuata l'espansione della tilde. Di conseguenza, si possono usare nomi di file con delle tilde negli assegnamenti a PATH, MAILPATH, e CDPATH, e la shell assegna il valore espanso.

Espansione di parametro¶

Il carattere `$' introduce l'espansione di parametro, la sostituzione di comando, o l'espansione aritmetica. Il nome o simbolo del parametro che dev'essere espanso può essere racchiuso tra parentesi graffe, che sono opzionali ma servono a proteggere la variabile che deve essere espansa dai caratteri immediatamente seguenti, che potrebbero essere interpretati come parte del nome [della variabile stessa].

Quando vengono usate le parentesi graffe, la parentesi graffa finale corrispondente è la prima `}' non protetta da un backslash o da stringhe quotate, e non parte di un'espansione aritmetica inclusa, di una sostituzione di comando o di un'espansione di parametro.

${parametro}

Il valore di parametro è sostituito. Le parentesi graffe sono richieste quando parametro è un parametro posizionale con più di una cifra [ossia 10 e oltre], o quando parametro è seguito da un carattere che non deve essere interpretato come parte del suo nome.

Se il primo carattere di parametro è un punto esclamativo, è introdotto un livello di indirezione della variabile. Bash usa il valore della variabile formata dal resto del parametro come nome di variabile; questa variabile è poi espansa e quel valore è usato nel resto della sostituzione, piuttosto che il valore stesso di parametro. Questa è conosciuta come espansione indiretta. Le eccezioni a ciò sono le espansioni di ${!prefisso*} e ${!nome[@]} descritte più avanti. Il punto esclamativo deve seguire immediatamente la parentesi graffa iniziale per introdurre l'indirezione.

In ognuno dei casi sotto riportati, parola è soggetta a espansione della tilde, espansione di parametro, sostituzione di comando ed espansione aritmetica. Quando non sta effettuando l'espansione della substringa, Bash controlla se un parametro non è impostato o è nullo; l'omissione dei due punti provoca il solo controllo di un parametro non impostato.

${parametro:-parola}

Usa i valori di default. Se parametro non è impostato o è nullo, è sostituita l'espansione di R parola . Altrimenti, il valore di R parametro è sostituito

${parametro:=parola}

Assegna i valori di default. Se parametro non è impostato o è nullo, l'espansione di parola è assegnata a R parametro . Il valore di parametro è quindi sostituito. I parametri posizionali e i parametri speciali non possono essere assegnati in questo modo.

${parametro:?parola}

Dà una segnalazione di errore se è nullo o è stato annullato. Se parametro è nullo o è stato annullato, l'espansione di parola (o un messaggio di segnalazione, se parola non è presente) viene scritta sullo standard error e la shell, se non è interattiva, termina. Altrimenti, è sostituito il valore di parametro.

${parametro:+parola}

Usa un valore alternativo. Se parametro è nullo o è stato annullato, non è sostituito niente, altrimenti è sostituita l'espansione di parola .

${parametro:offset}

${parametro:offset:lunghezza}

Espansione di substringa. Espande i caratteri di parametro fino a lunghezza partendo dal carattere specificato da offset. Se lunghezza viene omesso, espande alla substringa di parametro partendo dal carattere specificato da offset. lunghezza e offset sono espressioni aritmetiche (si veda VALUTAZIONE ARITMETICA più avanti). lunghezza deve essere un numero maggiore o uguale a zero. Se offset è un numero minore di zero, il valore viene usato come un offset dalla fine del valore di parametro. Se parametro è @, il risultato è un numero di parametri posizionali pari a lunghezza a partire da offset. Se parametro è un nome di array indicizzato da @ o *, il risultato è un numero di elementi dell'array pari a lunghezza a partire da ${parametro[offset]}. Un offset negativo è inteso come relativo al massimo indice dell'array specificato aumentato di uno. Notare che un offset negativo dev'essere separato dai due punti da almeno uno spazio per evitare di essere confuso con l'espansione di :- . L'indicizzazione della substringa è a base zero a meno che non vengano usati i parametri posizionali, nel qual caso l'indicizzazione parte da 1.

${!prefisso*}

${!prefisso@}

Espande ai nomi delle variabili i cui nomi iniziano con prefisso, separati dal primo carattere della variabile speciale IFS

${!nome[@]}

${!nome[*]}

Se nome è una variabile di array, espande alla lista degli indici di array (chiavi) assegnati in nome. Se nome non è un array, espande a 0 se nome è impostato ed è nullo in caso contrario. Quando @ è usato e l'espansione appare fra virgolette, ogni chiave espande a una parola separata.

${#parametro}

È sostituita la lunghezza in caratteri del valore di parametro. Se parametro è * o @, il valore sostituito è il numero di parametri posizionali. Se parametro è un nome di array contrassegnato da * o @, il valore sostituito è il numero di elementi nell'array.

${parametro#parola}

${parametro##parola}

La parola è espansa per produrre un modello proprio come nell'espansione di percorso. Se il modello trova una corrispondenza con l'inizio del valore di R parametro , allora il risultato dell'espansione è il valore espanso di parametro con il più corto dei modelli che corrispondono cancellato (nel caso di ``#'' ) o il più lungo dei modelli che corrispondono cancellato (nel caso di ``##'' ). Se parametro è @ o *, l'operazione di rimozione del modello è applicata di volta in volta a ogni parametro posizionale, e l'espansione è la lista che ne risulta. Se parametro è una variabile di array con indice @ o *, l'operazione di rimozione del modello è applicata a ognuno degli elementi dell'array, e l'espansione è la lista risultante.

${parametro%parola}

${parametro%%parola}

La parola è espansa per produrre un modello proprio come nell'espansione di percorso. Se il modello corrisponde a una parte finale del valore espanso di R parametro , il risultato dell'espansione è il valore espanso di parametro con il più corto dei modelli corrispondenti cancellato (nel caso di ``%'' ) o il più lungo dei modelli corrispondenti cancellato (nel caso di ``%%''). Se parametro è @ o *, l'operazione di rimozione del modello è applicata a ognuno dei parametri posizionali, e l'espansione è la lista risultante. Se parametro è una variabile di array con indice @ o *, l'operazione di rimozione del modello è applicata a ognuno degli elementi dell'array, e l'espansione è la lista risultante.

${parametro/modello/stringa}

Il modello è espanso per produrre un modello proprio come nell'espansione di percorso. Parametro è espanso e il suo valore più lungo che corrisponde a modello è sostituito con stringa. Se modello comincia con /, tutte le corrispondenze di modello sono sostituite con stringa. Normalmente viene sostituita solo la prima corrispondenza. Se modello comincia con #, deve corrispondere all'inizio del valore espanso di parametro. Se modello inizia con %, deve corrispondere alla fine del valore espanso di parametro. Se stringa è nulla, le corrispondenze di modello sono cancellate e la / che segue modello può essere omessa. Se parametro è @ o *, l'operazione di sostituzione è applicata a ognuno dei parametri posizionali, e l'espansione è la lista risultante. Se parametro è una variabile di array con indice @ o *, l'operazione di sostituzione è applicata a ognuno degli elementi dell'array, e l'espansione è la lista risultante.

Sostituzione di comando¶

La sostituzione di comando permette che l'output di un comando rimpiazzi il nome del comando. Vi sono due forme:

Bash effettua l'espansione eseguendo il comando e rimpiazzando la sostituzione di comando con lo standard output del comando, con ogni newline finale cancellato. I newline intermedi non vengono cancellati, ma possono essere rimossi durante la suddivisione in parole. La sostituzione di comando $(cat file) può essere sostituita dall'equivalente ma più veloce $(< file).

Quando è usata la forma di sostituzione in vecchio stile con gli apici rovesciati, il backslash conserva il suo significato letterale tranne quando è seguito da $, ` o \. Il primo apice rovesciato non preceduto da un backslash fa terminare la sostituzione di comando. Quando si usa la forma $(comando), tutti i caratteri tra le parentesi formano il comando; nessuno è considerato speciale.

La sostituzione di comando può essere nidificata. Per nidificare quando si usa la forma con gli apici rovesciati, bisogna far precedere gli apici rovesciati più interni con un carattere backslash di protezione.

Se la sostituzione appare tra virgolette, la suddivisione in parole e l'espansione di percorso non sono effettuate sui risultati.

Espansione aritmetica¶

L'espansione aritmetica permette la valutazione di una espressione aritmetica e la sostituzione del risultato. Il formato per l'espansione aritmetica è:

L' espressione è trattata come se fosse tra virgolette, ma le virgolette dentro le parentesi non sono trattate in modo speciale. Tutti i token dell'espressione sono assoggettati a espansione di parametro, espansione di stringa, sostituzione di comando e rimozione dei caratteri di quotatura. Le espansioni aritmetiche possono essere nidificate.

Il calcolo è effettuato in accordo con le regole elencate più avanti sotto VALUTAZIONE ARITMETICA. Se espressione non è valida, bash stampa un messaggio che indica l'errore e non viene effettuata alcuna sostituzione.

Sostituzione di processo¶

La sostituzione di processo è supportata su sistemi che supportano le named pipe (FIFO) o il metodo /dev/fd per denominare i file aperti. Essa prende la forma di <(lista) o >(lista). La lista di processi è eseguita con il suo input o output connesso a un FIFO o ad alcuni file in /dev/fd. Il nome di questo file è passato come argomento al comando corrente come risultato dell'espansione. Se è usata la forma >(lista), la scrittura sul file fornisce input per la lista. Se è usata la forma <(lista), il file passato come argomento dovrebbe essere letto per ottenere l'output di lista.

Su sistemi che la supportano, la sostituzione di processo è effettuata allo stesso momento dell'espansione di parametro e di variabile, della sostituzione di comando e dell'espansione aritmetica.

Suddivisione in parole¶

La shell scandisce il risultato dell'espansione di parametro, sostituzione di comando ed espansione aritmetica che non si trovano tra virgolette, per effettuare la R suddivisione in parole .

La shell tratta ogni carattere di IFS come un delimitatore, e suddivide in parole, in corrispondenza con uno di questi caratteri, i risultati delle altre espansioni. Se il valore di IFS non è impostato o il suo valore è esattamente <space><tab><newline>, il valore di default, qualsiasi sequenza di caratteri IFS serve per delimitare le parole. Se IFS ha un valore diverso da quello di default, allora sequenze di caratteri di spaziatura space e tab sono ignorate all'inizio e alla fine della parola, se il carattere di spaziatura è presente nel valore di IFS (un carattere di spaziatura IFS ). Qualunque carattere in IFS che non è un carattere di spaziatura IFS, insieme con qualsiasi carattere di spaziatura IFS adiacente, delimita un campo. Una sequenza di caratteri di spaziatura IFS è anche trattata come un delimitatore. Se il valore di IFS è nullo, non avviene alcuna suddivisione in parole.

Argomenti esplicitamente nulli("" or '') sono conservati. Argomenti non quotati implicitamente nulli, risultanti dall'espansione di parametri con valore nullo, sono rimossi. Se un parametro con valore nullo è espanso fra virgolette, è considerato un argomento nullo e viene rimosso.

È da notare che se non avviene alcuna espansione non viene effettuata alcuna suddivisione.

Espansione di percorso¶

Dopo la suddivisione in parole, a meno che non sia stata impostata l'opzione -f, bash scandisce ogni parola alla ricerca di caratteri *, ? e [. Se uno di questi caratteri è presente, allora la parola è considerata come un R modello , e sostituita con una lista, in ordine alfabetico, di nomi di file che corrispondono al modello. Se nessun nome di file corrispondente viene trovato, e l'opzione di shell nullglob è disabilitata, la parola è lasciata inalterata. Se l'opzione nullglob è impostata, e nessuna corrispondenza è trovata, la parola è rimossa. Se l'opzione di shell failglob è impostata, e non viene trovata alcuna corrispondenza, viene stampato un messaggio di errore e il comando non viene eseguito. Se l'opzione di shell nocaseglob è abilitata, il confronto è effettuato senza distinzione fra maiuscole e minuscole nei caratteri alfabetici. Quando un modello è usato per l'espansione di percorso, il carattere ``.'' all'inizio di un nome o immediatamente dopo una barra [/] deve essere confrontato esplicitamente, a meno che l'opzione di shell globdot non sia impostata. Quando si confronta un percorso, il carattere barra [/] deve sempre essere confrontato esplicitamente. Negli altri casi, il carattere ``.'' non è trattato in modo speciale. Vedere la descrizione di shopt più avanti sotto COMANDI INCORPORATI DELLA SHELL per una descrizione delle opzioni di shell nocaseglob, nullglob, failglob e dotglob .

La variabile di shell GLOBIGNORE può essere usata per restringere la serie di nomi di file che corrispondono a un R modello . Se GLOBIGNORE è impostato, ogni nome di file da confrontare che corrisponde anche a uno dei modelli in GLOBIGNORE è rimosso dalla lista dei nomi che corrispondono al modello. I nomi di file ``.'' e ``..'' sono sempre ignorati quando GLOBIGNORE è impostato e non nullo. Comunque, impostare GLOBIGNORE a un valore non nullo ha l'effetto di abilitare l'opzione di shell dotglob , così da cercare una corrispondenza con tutti gli altri nomi di file che iniziano con un ``.'' Per ottenere il comportamento (usato in precedenti versioni) di ignorare i nomi di file che iniziano con ``.'', si deve fare un modello ``.*'' in GLOBIGNORE. L'opzione dotglob è disabilitata quando GLOBIGNORE viene annullato.

Modelli di ricerca / espressioni regolari

Ogni carattere che appare in un modello (espressione regolare), tranne quelli speciali descritti qui sotto, corrisponde a se stesso. Il carattere NULL non può far parte di un'espressione regolare. Un backslash segnala come speciale il carattere che segue; il backslash è ignorato durante il confronto. I caratteri speciali del modello devono essere racchiusi tra apici se si vuole che siano considerati così come sono scritti.

I caratteri speciali nelle espressioni regolari hanno i seguenti significati:

*

Corrisponde a qualsiasi stringa, inclusa la stringa nulla.

?

Corrisponde a qualsiasi carattere singolo.

[...]

Corrisponde a uno qualsiasi dei caratteri racchiusi fra parentesi quadre. Una coppia di caratteri separati da un segno meno denota un' espressione di intervallo, che individua ogni carattere che si trova tra quei due caratteri, essi stessi inclusi, usando la sequenza di ordinamento della localizzazione corrente. Se il primo carattere che segue il [ è un ! o un ^ allora qualsiasi carattere non specificato è ritenuto corrispondente. L'ordine di ordinamento dei caratteri nell'espressione di intervallo è determinato dalla localizzazione corrente e dal valore della variabile di shell LC_COLLATE, se impostata. Un - può essere specificato includendolo come primo o ultimo carattere nella lista. Una ] può essere specificata includendola come primo carattere nella lista.

All'interno di [ e ], possono essere specificate classi di caratteri usando la sintassi [:classe:], dove classe è una delle seguenti classi definite nello standard POSIX:

Se l'opzione di shell extglob è abilitata col comando incorporato shopt, vengono riconosciuti diversi operatori estesi che descrivono modelli. Nella descrizione seguente, una pattern-list è una lista di uno o più modelli separati da una |. Possono essere formati modelli composti usando uno o più dei seguenti submodelli:

Rimozione dei caratteri di quotatura¶

Dopo le precedenti espansioni, tutte le occorrenze non quotate dei caratteri \, ' e " non originate da una delle espansioni di cui sopra sono rimosse.

Ridirezione dell'input¶

La ridirezione dell'input fa sì che il file il cui nome risulta dall'espansione di parola venga aperto in lettura sul descrittore di file R n , o come standard input (descrittore di file 0) se n non è specificato.

Il formato generico per ridirigere l'input è:

Ridirezione dell'output¶

La ridirezione dell'output fa sì che il file il cui nome risulta dall'espansione di parola venga aperto in scrittura sul descrittore di file R n , o come standard output (descrittore di file 1) se n non è specificato. Se il file non esiste viene creato; se esiste viene sovrascritto, come se fosse di dimensione zero.

Il formato generico per ridirigere l'output è:

Se l'operatore di ridirezione è >, e l'opzione noclobber del comando incorporato set è stata abilitata, la ridirezione non ha successo se il file il cui nome risulta dall'espansione di parola esiste ed è un file regolare. Se l'operatore di ridirezione è >|, o l'operatore di ridirezione è > e l'opzione noclobber del comando incorporato set non è abilitata, la ridirezione è tentata anche se il file denominato da parola esiste.

Accodare l'output ridiretto¶

La ridirezione dell'output in questo modalità fa sì che il file il cui nome risulta dall'espansione di parola venga aperto per accodare sul descrittore di file R n , o sullo standard output (descrittore di file 1) se n non è specificato. Se il file non esiste viene creato.

Il formato generico per accodare l'output è:

Ridirezione di standard output e standard error¶

Bash permette, con questo costrutto, che l'output sia lo standard output (descrittore di file 1) che quello dello standard error (descrittore di file 2) siano ridiretti sul file il cui nome risulta dall'espansione di R parola .

Vi sono due formati per ridirigere lo standard output e lo standard error:

Delle due forme, la prima è quella preferita. Questo è semanticamente equivalente a

Here Document¶

Questo tipo di ridirezione istruisce la shell a leggere l'input dall'input corrente, finché non venga incontrata una riga contenente solo parola (senza alcun carattere blank dopo la parola stessa). Tutte le righe lette fino a quel punto sono quindi usate come standard input per un comando.

Il formato degli here-document è il seguente:

<<[-]parola


        here-document
delimitatore

Nessuna espansione di parametro, sostituzione di comando, espansione aritmetica o espansione di percorso è effettuata su R parola . Se un carattere qualsiasi in parola è quotato, il delimitatore è il risultato della rimozione dei caratteri di quotatura da R parola , e le righe nel here-document non vengono espanse. Se parola non è quotata, tutte le righe del here-document sono soggette a espansione di parametro, sostituzione di comando ed espansione aritmetica. In quest'ultimo caso, la coppia \<newline> è ignorata, e \ deve essere usata per quotare i caratteri \, $, e `.

Se l'operatore di ridirezione è <<-, tutti i caratteri tab a inizio riga sono eliminati dalle righe in input e dalla riga che contiene R delimitatore . Questo permette che un here-document dentro uno script di shell possa essere indentato in maniera naturale.

Here String¶

Una variante degli here document, il formato è:

<<<parola

La parola è espansa ed è passata al comando come suo standard input.

Duplicazione dei descrittori di file¶

L'operatore di ridirezione

è usato per duplicare descrittori di file di input. Se parola si espande in una o più cifre, il descrittore di file indicato da n è fatto diventare una copia di quel descrittore di file. Se le cifre in parola non specificano un descrittore di file aperto per l'input, si verifica un errore di ridirezione. Se parola risulta essere, dopo l'espansione, -, il descrittore di file n viene chiuso. Se n non è specificato, è usato lo standard input (descrittore di file 0).

L'operatore

è usato in modo analogo per duplicare i descrittori di file di output. Se n non è specificato, è usato lo standard output (descrittore di file 1). Se le cifre in parola non specificano un descrittore di file aperto in output, si verifica un errore di ridirezione. Come caso speciale, se n è omesso, e parola non si espande a una o più cifre, lo standard output e lo standard error sono ridiretti come descritto in precedenza.

Muovere i descrittori di file¶

L'operatore di ridirezione

muove il descrittore di file cifra al descrittore di file R n , o allo standard input (descrittore di file 0) se n non è specificato. cifra è chiuso dopo essere stato duplicato in n.

Analogamente l'operatore di ridirezione

muove il descrittore di file cifra al descrittore di file R n , o allo standard output (descrittore di file 1) se n non è specificato.

Apertura di descrittori di file per lettura e scrittura¶

L'operatore di ridirezione

fa sì che il file il cui nome è l'espansione di parola venga aperto sia in lettura che in scrittura sul descrittore di file R n , o sul descrittore di file 0 se n non è specificato. Se il file non esiste, viene creato.

Notazione readline¶

In questa sezione, si usa la notazione in stile emacs per indicare i tasti da battere. I tasti di controllo sono indicati da C-tasto, per esempio, C-n significa Control-N. In modo simile, i meta tasti sono indicati da M-tasto, cioè M-x significa Meta-X. (Sulle tastiere senza un tasto meta , M-x significa ESC x, cioè, si preme il tasto Escape e poi il tasto x . Questo rende ESC il meta prefisso. La combinazione M-C-x significa ESC-Control-x, ossia si preme il tasto Escape poi si tiene il tasto Control mentre si preme il tasto x ).

Ai comandi readline possono essere specificati R argomenti numerici che normalmente sono dei contatori di ripetizione. A volte, tuttavia, è il segno dell'argomento a essere significativo. Passando un argomento negativo a un comando che agisce in avanti (ad es., kill-line), il comando agisce nella direzione opposta. I comandi il cui comportamento con gli argomenti è diverso da questo sono indicati più avanti.

Quando un comando è descritto come eliminazione di testo, il testo cancellato viene salvato per un possibile riutilizzo futuro (yanking). Il testo eliminato viene salvato in un kill-ring. Eliminazioni consecutive provocano l'accumulazione del testo in una unità, che può essere recuperata tutta in una volta. Comandi che non eliminano testo separano parti di testo nel kill-ring.

Inizializzazione di Readline¶

Readline è personalizzata inserendo comandi in un file di inizializzazione (il file inputrc ). Il nome di questo file è preso dal valore della variabile INPUTRC . Se questa variabile non è definita il valore di default è R ~/.inputrc . Quando un programma che usa la libreria readline viene avviato, viene letto il file di inizializzazione, e vengono impostate le associazioni di tasti e assegnate le variabili. Ci sono solo alcuni costrutti base consentiti nel file d'inizializzazione di readline. Le righe vuote sono ignorate. Le righe che iniziano con un # sono commenti. Le righe che iniziano con un $ indicano costrutti condizionali. Le altre righe indicano associazioni di tasti e impostazioni di variabili.

Le associazioni di tasti di default possono essere cambiate con un file inputrc . Altri programmi che usano questa libreria possono aggiungere i loro propri comandi e associazioni.

Per esempio, porre

Sono riconosciuti i seguenti nomi simbolici di carattere: R RUBOUT , R DEL , R ESC , R LFD , R NEWLINE , R RET , R RETURN , R SPC , R SPACE e R TAB .

In aggiunta al nome del comando, readline consente che a un tasto corrisponda una stringa che è inserita quando quel tasto è premuto (una macro).

Associazioni di tasti readline¶

La sintassi per il controllo delle associazioni dei tasti nel file inputrc è semplice. Tutto quel che è richiesto è il nome del comando o il testo di una macro e una sequenza di tasti alla quale dovrà essere associato. Il nome può essere specificato in uno di due modi: come nome simbolico di un tasto, eventualmente con i prefissi Meta- o Control-, o come una sequenza di tasti.

Quando si usa la forma nome-tasto:nome-funzione o macro, nome-tasto è il nome di un tasto in inglese. Per esempio:

Negli esempi precedenti, C-u viene collegato alla funzione universal-argument, M-DEL viene collegato alla funzione backward-kill-word, e C-o viene collegato all'esecuzione della macro indicata sul lato destro (cioè, inserire il testo ``> output'' nella riga).

Nella seconda forma, "sequenza-tasti":nome-funzione o macro, sequenza-tasti differisce da nome-tasto visto sopra, per il fatto che la stringa che denota un'intera sequenza di tasti può essere specificata ponendo la sequenza fra virgolette. Alcuni tasti di protezione (escape) nello stile GNU Emacs possono essere usati, come nei seguenti esempi, ma i nomi simbolici dei caratteri non si possono utilizzare.

In questo esempio, C-u viene ancora collegato alla funzione universal-argument. C-x C-r viene collegato alla funzione re-read-init-file, e ESC [ 1 1 ~ viene collegato all'inserimento del testo ``Function Key 1''.

L'insieme completo delle sequenze di protezione (escape) in stile GNU Emacs è

In aggiunta alle sequenze di protezione che iniziano col tasto escape in stile GNU Emacs, è disponibile un secondo insieme di sequenze di protezione che iniziano con il backslash:

Quando si inserisce il testo di una macro, apostrofi o virgolette devono essere usati per indicare una definizione di macro. Un testo non quotato si suppone essere [che sia] un nome di funzione. Nel corpo della macro, i segni di protezione backslash descritti prima vengono espansi. Il backslash quota qualsiasi altro carattere nel testo della macro, inclusi " e '.

Bash permette di mostrare o modificare le associazioni correnti dei tasti di readline con il comando incorporato bind . Il modo di editing può essere cambiato durante l'uso interattivo usando l'opzione -o del comando incorporato set (si veda COMANDI INCORPORATI DELLA SHELL più avanti).

Variabili readline¶

Readline ha delle variabili che possono essere usate per personalizzare ulteriormente il suo comportamento. Una variabile può essere impostata nel file inputrc con un'istruzione della forma

Tranne dove diversamente indicato, le variabili di readline possono avere i valori On o Off (senza distinzione fra maiuscole e minuscole). I nomi di variabile non riconosciuti vengono ignorati. Quando viene letto un valore di variabile, i valori vuoti o nulli, "on" (senza distinzione fra maiuscole e minuscole) o "1" sono equivalenti a On. Tutti gli altri valori sono equivalenti a Off. Le variabili e i loro valori di default sono:

bell-style (audible)

Controlla cosa succede se readline vuole usare il segnalatore acustico del terminale. Se impostato a none, readline non emette alcun segnale. Se impostato a visible, readline usa un segnalatore visivo se disponibile. Se impostato a audible, readline tenta di attivare il segnalatore acustico del terminale.

bind-tty-special-chars (On)

Se impostato a On, readline tenta di associare i caratteri di controllo trattati in modo speciale dal driver del terminale nel kernel agli equivalenti degli stessi come descritti da readline.

comment-begin (``#'')

La stringa che è inserita quando è eseguito il comando insert-comment . Questo comando è associato a M-# in modalità comandi Emacs e a # in modalità comandi di vi.

completion-ignore-case (Off)

Se impostato a On, readline effettua l'individuazione dei nomi di file e il completamento seza distinguere le lettera maiuscole dalle lettere minuscole.

completion-query-items (100)

Questo determina a che punto interpellare l'utente per visualizzare i possibili completamenti generati dal comando possible-completions. Può essere impostato a un numero intero maggiore o uguale a zero. Se il numero di possibili completamenti è maggiore o uguale al valore di questa variabile, all'utente viene chiesto se desidera o meno vederli; altrimenti essi sono semplicemente elencati sul terminale.

convert-meta (On)

Se impostato a On, readline converte i caratteri con l'ottavo bit uguale a 1 a una sequenza di caratteri ASCII eliminando l'ottavo bit e aggiungendo come prefisso un carattere di protezione (in pratica, usando l'escape come prefisso meta).

disable-completion (Off)

Se impostato a On, readline inibisce il completamento della parola. I caratteri di completamento saranno inseriti nella riga come se fossero stati mappati come self-insert.

editing-mode (emacs)

Controlla se readline parte con un insieme di associazioni di tasti simile a emacs o vi. editing-mode può essere impostato a emacs o a vi.

enable-keypad (Off)

Quando impostato a On, readline tenta di abilitare il tastierino numerico se viene utilizzato. Alcuni sistemi richiedono questo per abilitare i tasti-freccia.

expand-tilde (Off)

Se impostato a on, l'espansione della tilde è effettuata quando readline tenta il completamento della parola.

history-preserve-point (Off)

Se impostato a on, il codice che implementa la cronologia tenta di piazzare il cursore nel punto in cui si trovava su ogni riga della cronologia visualizzata con previous-history o next-history.

horizontal-scroll-mode (Off)

Quando impostato a On, richiede a readline di usare una sola riga per la visualizzazione, effettuando lo scroll dell'input in orizzontale su una sola riga dello schermo quando essa risulti più lunga della larghezza dello schermo, invece che andando a capo su una nuova riga.

input-meta (Off)

Se impostato a On, readline abilita l'input a otto bit (cioè, non toglie il bit più alto dai caratteri che legge), indipendentemente da quello che il terminale dichiara di supportare. Il nome meta-flag è un sinonimo per questa variabile.

isearch-terminators (``C-[C-J'')

Una stringa di caratteri che fa terminare una ricerca incrementale senza eseguire successivamente il carattere come se fosse un comando. Se a questa variabile non è stato dato un valore, i caratteri ESC and C-J fanno terminare una ricerca incrementale.

keymap (emacs)

Imposta la mappa corrente dei tasti di readline. Il set dei nomi validi per le mappe dei tasti è emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-command e R vi-insert . vi è equivalente a vi-command; emacs è equivalente a emacs-standard. Il valore di default è R emacs ; il valore di editing-mode determina anche la mappa dei tasti di default.

mark-directories (On)

Se impostata a On, ai nomi delle directory completate è aggiunta una barra [/] alla fine.

mark-modified-lines (Off)

Se impostato a On, le righe della cronologia che sono state modificate sono mostrate precedute da un asterisco (*).

mark-symlinked-directories (Off)

Se impostato a On, i nomi completati che sono collegamenti simbolici a directory hanno una barra [/] alla fine (se richiesto tramite mark-directories).

match-hidden-files (On)

Questa variabile, se impostata a On, fa sì che readline mostri anche i file i cui nomi iniziano con un `.' (file nascosti) quando effettua il completamento del nome di file, a meno che il `.' iniziale non sia fornito dall'utente come parte del nome di file da completare.

output-meta (Off)

Se impostato a On, readline mostra i caratteri con l'ottavo bit impostato direttamente, piuttosto che con una sequenza di protezione avente come prefisso meta.

page-completions (On)

Se impostato a On, readline usa un paginatore interno simile a more per mostrare i possibili completamenti una schermata alla volta.

print-completions-horizontally (Off)

Se impostato a On, readline mostra i completamenti ordinati in ordine alfabetico orizzontalmente, piuttosto che dall'alto in basso.

show-all-if-ambiguous (Off)

Questo cambia il comportamento di default delle funzioni di completamento. Se impostato a on, le parole che hanno più di un possibile completamento provocano la visualizzazione immediata delle coincidenze invece che l'attivazione del segnalatore acustico.

show-all-if-unmodified (Off)

Questo cambia il comportamento di default delle funzioni di completamento in maniera simile a show-all-if-ambiguous. Se impostato a on, le parole che hanno più di un possibile completamento senza alcun possibile completamento parziale (ovvero i possibili completamenti non hanno alcun prefisso in comune) sono elencate immediatamente invece che provocare l'attivazione del segnalatore acustico.

visible-stats (Off)

Se impostato a On, un carattere che denota un tipo di file come riportato da stat(2) è accodato al nome di file durante l'elencazione dei possibili completamenti.

Costrutto condizionale di readline¶

Readline implementa un servizio simile, nello spirito, a quello della compilazione condizionale nel preprocessore C, e che permette di effettuare associazioni di tasti e impostazioni di variabili in base al risultato di test. Vi sono tre direttive di controllo usate.

$if

Il costrutto $if permette che le associazioni siano fatte in base al modo di editing, al terminale in uso o all'applicazione che fa uso di readline. Il testo da verificare arriva fino alla fine della riga; nessun carattere che lo delimiti è richiesto.

$if Bash
# Quota la parola corrente o precedente
"\C-xq": "\eb\"\ef\""
$endif

$endif

Questo comando, come si è visto nell'esempio precedente, fa terminare un comando $if.

$else

I comandi in questa parte della direttiva $if sono eseguiti se il test non risulta verificato.

$include

Questa direttiva prende un unico nome di file come argomento e legge comandi e associazioni da quel file. Per esempio, la seguente direttiva legge /etc/inputrc:

$include  /etc/inputrc

Ricerca¶

Readline è dotato di comandi per cercare nella cronologia dei comandi (si veda CRONOLOGIA più avanti) righe contenenti una stringa specifica. Ci sono due modalità di ricerca: incrementale e R non-incrementale .

La ricerca incrementale inizia prima che l'utente abbia finito di immettere la stringa di ricerca. Mentre ogni carattere della stringa di ricerca viene battuto, readline mostra la prima linea dalla cronologia che corrisponde alla stringa battuta finora. Una ricerca incrementale richiede solamente il numero minimo di caratteri necessari per trovare l'elemento della cronologia desiderato. I caratteri presenti nel valore della variabile isearch-terminators sono usati per delimitare una ricerca incrementale. Se a quella variabile non è stata assegnato un valore i caratteri di Escape e Control-J fanno arrestare una ricerca incrementale. Control-G interrompe una ricerca incrementale e ripristina la riga originale. Quando è terminata la ricerca, l'elemento della cronologia contenente la stringa di ricerca diventa la riga corrente.

Per trovare altri elementi nell'elenco della cronologia, battere Control-S o Control-R secondo il caso. Viene eseguita così una ricerca all'indietro o in avanti nella cronologia del successivo elemento che corrisponde alla stringa di ricerca che è stata immessa. Ogni altra sequenza di tasti associata a un comando readline pone termine alla ricerca ed esegue il comando presente nella linea. Per esempio, un newline provoca l'interruzione della ricerca e accetta la riga, eseguendo così il comando proveniente dall'elenco della cronologia.

Readline ricorda l'ultima stringa di ricerca incrementale. Se due Control-R vengono battuti senza che siano intervenuti caratteri che definiscono una nuova stringa di ricerca, viene utilizzata la stringa di ricerca memorizzata al momento.

Le ricerche non incrementali leggono l'intera stringa di ricerca prima di avviare la ricerca per individuare righe nella cronologia. La stringa di ricerca può essere battuta dall'utente o essere parte del contenuto della riga corrente.

Nomi di comando readline¶

La seguente è una lista di nomi dei comandi e delle sequenze di tasti di default a cui essi sono collegati. Nomi di comando senza una sequenza di tasti collegata a essi sono scollegati per default. Nelle descrizioni seguenti, punto si riferisce alla posizione corrente del cursore e marca alla posizione del cursore salvata col comando set-mark. Il testo fra il punto e la marca è indicato come regione.

Comandi di movimento¶

beginning-of-line (C-a)

Si sposta all'inizio della riga corrente.

end-of-line (C-e)

Si sposta alla fine della riga.

forward-char (C-f)

Si sposta avanti di un carattere.

backward-char (C-b)

Si sposta indietro di un carattere.

forward-word (M-f)

Si sposta in avanti fino alla fine della parola successiva. Le parole sono composte di caratteri alfanumerici (lettere e cifre).

backward-word (M-b)

Si sposta indietro all'inizio della parola corrente o precedente. Le parole sono composte di caratteri alfanumerici (lettere e cifre).

clear-screen (C-l)

Pulisce lo schermo lasciando la riga corrente in cima allo schermo. Con un argomento, rinfresca la riga corrente senza ripulire lo schermo.

redraw-current-line

Rinfresca la riga corrente.

Comandi per manipolare la cronologia¶

accept-line (Newline, Return)

Accetta la riga senza curarsi di dove sia il cursore. Se questa riga non è vuota, è aggiunta alla lista della cronologia in accordo con lo stato della variabile HISTCONTROL. Se la riga è una riga di cronologia modificata, allora ripristina la riga di cronologia al suo stato originale.

previous-history (C-p)

Prende il precedente comando dalla lista della cronologia, spostandosi indietro nella lista.

next-history (C-n)

Prende il successivo comando dalla lista della cronologia, spostandosi avanti nella lista.

beginning-of-history (M-<)

Si sposta alla prima riga nella cronologia.

end-of-history (M->)

Si sposta alla fine della cronologia dell'input, cioè, alla riga che si sta inserendo.

reverse-search-history (C-r)

Cerca all'indietro partendo dalla riga corrente spostandosi in `su' attraverso la cronologia come necessario. Questa è una ricerca incrementale.

forward-search-history (C-s)

Cerca in avanti partendo dalla riga corrente e spostandosi in `giù' attraverso la cronologia come necessario. Questa è una ricerca incrementale.

non-incremental-reverse-search-history (M-p)

Cerca all'indietro attraverso la cronologia, partendo dalla riga corrente, una stringa fornita dall'utente, usando una ricerca non incrementale.

non-incremental-forward-search-history (M-n)

Cerca in avanti attraverso la cronologia una stringa fornita dall'utente, usando una ricerca non incrementale.

history-search-forward

Cerca in avanti attraverso la cronologia una stringa di caratteri tra l'inizio della riga corrente e il punto del cursore. Questa è una ricerca non incrementale.

history-search-backward

Cerca all'indietro attraverso la cronologia una stringa di caratteri tra l'inizio della riga corrente e il punto del cursore. Questa è una ricerca non incrementale.

yank-nth-arg (M-C-y)

Inserisce il primo argomento del comando precedente (generalmente la seconda parola sulla riga precedente) alla posizione del cursore. Con un argomento R n , inserisce la n-sima parola del comando precedente (le parole nel comando precedente iniziano con la parola 0). Un argomento negativo inserisce la n-sima parola dalla fine del comando precedente. Una volta che l'argomento n è calcolato, l'argomento è estratto come se l'espansione della cronologia "!n" sia stata specificata.

yank-last-arg (M-., M-_)

Inserisce l'ultimo argomento del comando precedente (l'ultima parola della precedente riga di cronologia). Con un argomento, si comporta esattamente come yank-nth-arg. Chiamate consecutive a yank-last-arg percorrono l'elenco della cronologia all'indietro, inserendo ogni volta l'ultimo argomento di ogni riga. I servizi dell'espansione della cronologia sono usati per estrarre l'ultimo argomento, come se fosse stata specificata l'espansione della cronologia "!$".

shell-expand-line (M-C-e)

Espande la riga nello stesso modo in cui lo fa la shell. Questo effettua l'espansione degli alias e della cronologia così come tutte le espansioni di parola della shell. Si veda ESPANSIONE DELLA CRONOLOGIA più avanti per una descrizione dell'espansione della cronologia.

history-expand-line (M-^)

Effettua l'espansione della cronologia sulla riga corrente. Si veda ESPANSIONE DELLA CRONOLOGIA più avanti per una descrizione dell'espansione della cronologia.

magic-space

Effettua l'espansione della cronologia sulla riga corrente e inserisce uno spazio. Si veda ESPANSIONE DELLA CRONOLOGIA più avanti per una descrizione dell'espansione della cronologia.

alias-expand-line

Effettua l'espansione degli alias sulla riga corrente. Si veda ALIAS sopra per una descrizione dell'espansione degli alias.

history-and-alias-expand-line

Effettua l'espansione della cronologia e degli alias sulla riga corrente.

insert-last-argument (M-., M-_)

Un sinonimo di yank-last-arg.

operate-and-get-next (C-o)

Accetta la riga corrente per l'esecuzione e prende dalla cronologia la riga successiva a quella corrente, per l'editing. Qualsiasi argomento viene ignorato.

edit-and-execute-command (C-xC-e)

Invoca un editor sulla riga di comando corrente ed esegue il risultato come comandi di shell. Bash tenta di invocare $FCEDIT, $EDITOR e emacs come editor, in quest'ordine.

Comandi per cambiare il testo¶

delete-char (C-d)

Cancella il carattere nel punto del cursore. Se il punto è all'inizio della riga, non vi è alcun carattere nella riga, e l'ultimo carattere battuto non era associato a delete-char, allora ritorna EOF.

backward-delete-char (Rubout)

Cancella il carattere dopo il cursore. Quando è dato un argomento numerico, salva il testo cancellato sul kill-ring.

forward-backward-delete-char

Cancella il carattere sotto il cursore, a meno che il cursore non sia alla fine della riga, nel qual caso il carattere dietro al cursore viene cancellato.

quoted-insert (C-q, C-v)

Aggiunge il successivo carattere battuto sulla riga in modo letterale. Questo è il modo per inserire caratteri come C-q, per esempio.

tab-insert (C-v TAB)

Inserisce un carattere tab.

self-insert (a, b, A, 1, !, ...)

Inserisce il carattere battuto.

transpose-chars (C-t)

Trascina il carattere prima del punto del cursore in avanti sopra il carattere nel punto, spostando anche il punto in avanti. Se il punto è alla fine della riga, traspone i due caratteri prima del punto. Argomenti negativi non hanno effetto.

transpose-words (M-t)

Trascina la parola prima del punto del cursore dopo la parola oltre il punto, spostando inoltre il punto sopra quella parola. Se il punto è alla fine della riga, allora traspone le ultime due parole sulla riga.

upcase-word (M-u)

Rende maiuscola la parola corrente (o seguente). Con un argomento negativo, opera sulla parola precedente, ma non sposta il punto del cursore.

downcase-word (M-l)

Rende minuscola la parola corrente (o seguente). Con un argomento negativo, opera sulla parola precedente, ma non sposta il punto del cursore.

capitalize-word (M-c)

Rende maiuscola la prima lettera della parola corrente (o seguente). Con un argomento negativo, opera sulla parola precedente, ma non sposta il punto del cursore.

overwrite-mode

Alterna fra modalità inserimento e modalità di sovrascrittura. Con un argomento numerico esplicito positivo passa alla modalità sovrascrittura. Con un argomento numerico esplicito non positivo passa alla modalità inserimento. Questo comando riguarda solo la modalità emacs; la modalità vi sovrascrive in modo diverso. Ogni chiamata a readline() viene avviata in modalità inserimento. In modalità sovrascrittura i caratteri associati a self-insert sostituiscono il testo nel punto del cursore piuttosto che sospingere il testo verso destra. I caratteri associati a backward-delete-char sostituiscono il carattere prima del punto con uno spazio. Questo comando è non associato per default.

Eliminazione e recupero¶

kill-line (C-k)

Elimina il testo dal punto del cursore fino alla fine della riga.

backward-kill-line (C-x C-Rubout)

Elimina all'indietro fino all'inizio della riga.

unix-line-discard (C-u)

Elimina all'indietro dal punto del cursore fino all'inizio della riga. Il testo eliminato viene salvato nel kill-ring

kill-whole-line

Elimina tutti i caratteri sulla riga corrente, non importa dove sia il punto del cursore.

kill-word (M-d)

Elimina dal punto del cursore fino alla fine della parola corrente, o se tra parole, fino alla fine della successiva parola. I delimitatori di parola sono gli stessi usati da forward-word.

backward-kill-word (M-Rubout)

Elimina la parola dietro il punto del cursore. I delimitatori di parole sono gli stessi usati da forward-word.

unix-word-rubout (C-w)

Elimina la parola dietro il punto del cursore, usando gli spazi bianchi come delimitatori di parola. Il testo eliminato è salvato nel kill-ring.

unix-filename-rubout

Elimina la parola prima del punto del cursore, usando uno spazio bianco e il carattere barra [/] come delimitatori di parola. Il testo eliminato è salvato nel kill-ring.

delete-horizontal-space

Cancella tutti gli spazi e i tab attorno al punto del cursore.

kill-region

Elimina il testo nella regione corrente.

copy-region-as-kill

Copia il testo nella regione sul kill buffer.

copy-backward-word

Copia la parola prima del punto del cursore sul kill buffer. I delimitatori di parola sono gli stessi di backward-word.

copy-forward-word

Copia la parola dopo il punto del cursore sul kill buffer. I delimitatori di parola sono gli stessi di forward-word.

yank (C-y)

Copia il contenuto in cima al kill-ring e lo pone nel buffer nel punto del cursore.

yank-pop (M-y)

Ruota il kill-ring, e copia la nuova cima. Funziona solo dopo yank o yank-pop.

Argomenti numerici¶

digit-argument (M-0, M-1, ..., M--)

Aggiunge questa cifra all'argomento che sta già accumulando, o inizia un nuovo argomento. M-- avvia un argomento negativo.

universal-argument

Questo è un altro modo per specificare un argomento. Se il comando è seguito da una o più cifre, opzionalmente con un segno meno iniziale, queste cifre definiscono l'argomento. Se il comando è seguito da cifre, eseguendo universal-argument di nuovo termina l'argomento numerico, ma a parte questo viene ignorato. Come caso speciale, se questo comando è seguito immediatamente da un carattere che che non è né una cifra né un segno meno, il contatore degli argomenti per il comando successivo è moltiplicato per quattro. Il contatore è inizialmente uno, così eseguendo questa funzione la prima volta il contatore diventa quattro, la seconda volta il contatore diventa sedici, e così via.

Completamento¶

complete (TAB)

Tenta di effettuare il completamento del testo che precede il punto del cursore. Bash tenta il completamento trattando il testo, rispettivamente, come una variabile (se il testo inizia con $), nome di utente (se il testo comincia con ~), nome di host (se il testo comincia con @) o comando (inclusi alias e funzioni). Se nessuna di questi produce una risultato, viene tentato il completamento del nome di file.

possible-completions (M-?)

Elenca i possibili completamenti del testo che precede il punto del cursore.

insert-completions (M-*)

Inserisce tutti i completamenti del testo che precede il punto del cursore che sarebbero stati generati da possible-completions.

menu-complete

Simile a complete, ma sostituisce la parola da completare con una corrispondenza singola dalla lista dei possibili completamenti. Un'esecuzione ripetuta di menu-complete scorre la lista dei possibili completamenti, inserendo una corrispondenza alla volta. Alla fine della lista dei completamenti viene emesso un segnale acustico (dipendente dall'impostazione di bell-style) e il testo originale è ripristinato. Con un argomento n si sposta di n posizioni in avanti nella lista dei completamenti individuati; può essere usato un argomento negativo per spostarsi all'indietro nella la lista. Questo comando è da associare normalmente al tasto TAB, però non è associato per default.

delete-char-or-list

Cancella il carattere sotto il cursore se non si trova all'inizio o alla fine della riga (simile a delete-char). Se è alla fine della riga, si comporta in modo identico a possible-completions. Questo comando non è associato per default.

complete-filename (M-/)

Tenta il completamento del nome del file sul testo che precede il punto del cursore.

possible-filename-completions (C-x /)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come un nome di file.

complete-username (M-~)

Tenta il completamento del testo che precede il punto del cursore, trattandolo come un nome di utente.

possible-username-completions (C-x ~)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come un nome di utente.

complete-variable (M-$)

Tenta il completamento del testo che precede il punto del cursore, trattandolo come una variabile di shell.

possible-variable-completions (C-x $)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come una variabile di shell.

complete-hostname (M-@)

Tenta il completamento del testo che precede il punto del cursore, trattandolo come un nome di host.

possible-hostname-completions (C-x @)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come un nome di host.

complete-command (M-!)

Tenta il completamento del testo che precede punto del cursore, trattandolo come nome di comando. Il completamento di comando tenta di far combaciare il testo confrontandolo con alias, parole riservate, funzioni di shell, comandi incorporati di shell e, da ultimo, nomi di file eseguibili, in quest'ordine.

possible-command-completions (C-x !)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come un nome di comando.

dynamic-complete-history (M-TAB)

Tenta il completamento del testo che precede il punto del cursore, confrontando il testo con le righe della lista della cronologia cercando le possibili corrispondenze di completamento.

complete-into-braces (M-{)

Effettua il completamento del nome di file e insericse la lista dei possibili completamenti racchiusi tra parentesi graffe, rendendo la lista disponibile per la shell (si veda Espansione delle parentesi graffe sopra).

Macro di tastiera¶

start-kbd-macro (C-x ()

Inizia a salvare i caratteri battuti nella corrente macro di tastiera.

end-kbd-macro (C-x ))

Smette di salvare i caratteri battuti nella corrente macro di tastiera e memorizza la definizione.

call-last-kbd-macro (C-x e)

Riesegue l'ultima macro di tastiera definita, facendo sì che i caratteri nella macro appaiano come se fossero stati battuti sulla tastiera.

Varie¶

re-read-init-file (C-x C-r)

Legge il contenuto del file inputrc, e incorpora ogni associazione o assegnamento di variabile che trova.

abort (C-g)

Annulla il corrente comando di editing ed emette il segnale acustico del terminale (dipendente dall'impostazione di bell-style).

do-uppercase-version (M-a, M-b, M-x, ...)

Se il carattere x battuto assieme al tasto Meta è minuscolo, esegue il comando collegato al corrispondente carattere maiuscolo.

prefix-meta (ESC)

Definisce come tasto Meta il successivo carattere battuto. ESC f è equivalente a Meta-f.

undo (C-_, C-x C-u)

Undo incrementale, memorizzato separatamente per ogni riga.

revert-line (M-r)

Annulla tutti i cambiamenti fatti su questa riga. Questo è come eseguire il comando undo un numero di volte sufficiente a riportare la riga al suo stato iniziale.

tilde-expand (M-&)

Effettua l'espansione della tilde sulla parola corrente.

set-mark (C-@, M-<space>)

Imposta la marca in corrispondenza del punto del cursore. Se viene fornito un argomento numerico la marca viene impostato a quella posizione.

exchange-point-and-mark (C-x C-x)

Scambia il punto del cursore con la marca. La posizione corrente del cursore è impostata alla posizione salvata, e la vecchia posizione del cursore è salvata come marca.

character-search (C-])

Viene letto un carattere e il punto del cursore è spostato all'occorrenza successiva di quel carattere. Un contatore negativo cerca occorrenze precedenti.

character-search-backward (M-C-])

Viene letto un carattere e il punto del cursore è spostato all'occorrenza precedente di quel carattere. Un contatore negativo cerca occorrenze successive.

insert-comment (M-#)

Senza un argomento numerico il valore della variabile readline comment-begin è inserito all'inizio della riga corrente. Se è fornito un argomento numerico questo comando agisce come un interruttore: se i caratteri all'inizio della riga non corrispondono al valore di comment-begin, il valore viene inserito, altrimenti i caratteri in comment-begin vengono cancellati dall'inizio della riga. In entrambi i casi la riga viene accettata come se fosse stato battuto un codice di fine riga (newline). Il valore di default di comment-begin fa sì che questo comando trasformi la riga corrente in un commento di shell. Se un argomento numerico provoca la rimozione del carattere di commento, la riga verrà eseguita dalla shell.

glob-complete-word (M-g)

La parola prima del punto del cursore è trattata come un modello per l'espansione del percorso, con un asterisco aggiunto alla fine implicitamente. Questo modello viene usato per generare una lista di nomi di file corrispondenti a possibili completamenti.

glob-expand-word (C-x *)

La parola prima del punto del cursore è trattata come un modello per l'espansione del percorso, e la lista dei nomi di file individuati viene inserita, sostituendo la parola. Se viene fornito un argomento numerico viene aggiunto alla fine un asterisco prima dell'espansione del percorso.

glob-list-expansions (C-x g)

Viene mostrata la lista delle espansioni che sarebbero state generate da glob-expand-word e la riga è ridisegnata. Se viene fornito un argomento numerico, un asterisco è aggiunto prima dell'espansione del percorso.

dump-functions

Stampa tutte le funzioni e le loro associazioni di tasti sul file di output di readline. Se è fornito un argomento numerico, l'output è formattato in modo tale da poter essere inserito in un file inputrc.

dump-variables

Stampa tutte le variabili readline impostabili e i loro valori sul file di output di readline. Se viene fornito un argomento numerico l'output è formattato in modo tale da poter essere inserito in un file inputrc.

dump-macros

Stampa tutte le sequenze di tasti readline associate a macro e le stringhe da loro prodotte. Se viene fornito un argomento numerico l'uscita è formattata in modo tale da poter essere inserito in un file inputrc.

display-shell-version (C-x C-v)

Mostra l'informazione sulla versione della corrente istanza di bash.

Completamento programmabile¶

Quando viene tentato il completamento della parola per un argomento di un comando per il quale una specifica di completamento (una compspec) è stata definita col comando incorporato complete (si veda COMANDI INCORPORATI DELLA SHELL più avanti), vengono invocati i servizi di completamento programmabile.

Per prima cosa viene identificato il nome del comando. Se un comspec è stato definito per quel comando, il comspec è usato per generare la lista dei possibili completamenti per la parola. Se il nome del comando è un percorso completo di file, viene ricercato per primo un comspec per il percorso completo. Se non viene trovato nessun comspec per il percorso completo viene fatto un tentativo per trovare un comspec per la porzione che segue la barra [/] finale.

Un volta trovato un comspec, questo è usato per generare la lista delle parole corrispondenti. Se non viene trovato un comspec, viene effettuato il completamento di bash di default come descritto in precedenza, sotto Completamento.

Per prima cosa, sono usate le azioni specificate dal comspec. Sono restituite solo le corrispondenze che iniziano con la parola che dev'essere completata. Quando viene usata l'opzione -f o -d per il completamento del nome di file o della directory, la variabile di shell FIGNORE è usata per filtrare le corrispondenze.

In seguito, viene generato qualsiasi completamento specificato da un modello di espansione del nome di file all'opzione -G. Le parole generate dal modello non devono necessariamente corrispondere alla parola che dev'essere completata. La variabile di shell GLOBIGNORE non è usata per filtrare le corrispondenze, ma viene usata la variabile FIGNORE .

In seguito, viene considerata la stringa specificata come argomento all'opzione -W. La stringa è prima suddivisa usando i caratteri nella variabile speciale IFS come delimitatori. È rispettata la quotatura della shell. Ogni parola viene poi espansa usando espansione delle parentesi graffe, espansione della tilde, espansione di parametro e di variabile, sostituzione di comando ed espansione aritmetica, come descritto in precedenza, sotto ESPANSIONE. I risultati sono suddivisi usando le regole sopra descritte sotto Suddivisione in parole. I risultati dell'espansione sono confrontati con la parte iniziale della parola che dev'essere completata, e quelli che corrispondono diventano i possibili completamenti.

Dopo che queste corrispondenze sono state generate, viene invocata qualsiasi funzione di shell o comando specificato con le opzioni -F e -C. Quando il comando o funzione viene invocata, alle variabili COMP_LINE e COMP_POINT sono assegnati valori come descritto in precedenza, sotto Variabili di shell. Quando una funzione di shell sta per essere invocata, le variabili COMP_WORDS e COMP_CWORD sono pure impostate. Quando viene invocata una funzione o comando, il primo argomento è il nome del comando i cui argomenti sono stati completati, il secondo argomento è la parola da completare e il terzo argomento è la parola che precede la parola da completare sulla riga di comando corrente. Non viene effettuata nessuna azione di filtro sui completamenti generati confrontandoli con la parola da completare; la funzione o comando ha libertà completa nel generare le corrispondenze.

Qualsiasi funzione specificata con -F viene invocata per prima. La funzione può usare uno qualsiasi dei servizi di shell, incluso il comando incorporato compgen descritto più avanti, per generare le corrispondenze. la funzione deve mettere i possibili completamenti della variabile di array COMPREPLY .

In seguito, qualsiasi comando specificato con l'opzione -C viene invocato in un ambiente equivalente alla sostituzione di comando. Questo dovrebbe stampare una lista di completamenti, uno per riga, sullo standard output. Un backslash può essere usato per proteggere un newline, se necessario.

Una volta generati tutti i possibili completamenti, ogni filtro specificato con l'opzione -X viene applicato alla lista. Il filtro è un modello come quello usato per l'espansione di percorso; una & nel modello è sostituita col testo della parola da completare. Una & letterale si può indicare con un backslash di protezione; il backslash viene rimosso prima della ricerca di una corrispondenza. Ogni completamento che corrisponde al modello viene rimosso dalla lista. Un ! iniziale nega il modello; in questo caso ogni completamento non corrispondente al modello viene rimosso.

Infine, qualsiasi prefisso e suffisso specificato dalle opzioni - P e -S è aggiunto a ogni membro della lista di completamento e il risultato è restituito al codice di completamento readline come lista di completamenti possibili.

Se le azioni precedentemente applicate non generano corrispondenze, e a complete era stata fornita l'opzione -o dirnames quando era stato definito comspec, viene tentato il completamento come nome di directory.

Se a complete era stata fornita l'opzione -o plusdirs quando era stato definito comspec, viene tentato il completamento come nomi di directory e qualunque corrispondenza è aggiunta ai risultati delle altre azioni.

Per default, se viene trovato un comspec, qualsiasi cosa generi viene restituito al codice di completamento come insieme completo di completamenti possibili. I completamenti di bash di default non vengono tentati, e la readline di default del completamento del nome di file è disabilitata. Se l'opzione -o bashdefault era stata fornita a complete al momento della definizione di comspec, i completamenti di default di bash vengono tentati se il comspec non genera corrispondenze. Se l'opzione -o default era stata fornita a complete al momento della definizione di comspec, i completamenti di default di readline vengono effettuati se il comspec (e, se tentato, il completamento di default di bash) non genera corrispondenze.

Quando un comspec indica che è desiderato il completamento come nome di directory, le funzioni di completamento programmabile forzano readline ad aggiungere una barra [/] ai nomi completati che sono collegamenti simbolici a directory, dipendente dal valore della variabile di readline mark-directories, indipendentemente dall'impostazione della variabile di readline mark-symlinked-directories.

Designatore di evento¶

Un designatore di evento è un riferimento a un elemento di riga di comando nella lista della cronologia.

!

Inizia una sostituzione di cronologia, tranne quando seguita da un blank, newline, carriage return, = o ( (quando l'opzione di shell extglob è abilitata usando il comando incorporato shopt).

!n

Designa la riga di comando R n .

!-n

Designa la riga di comando corrente meno R n .

!!

Designa il comando precedente. Questo è un sinonimo per `!-1'.

!stringa

Designa il comando più recente che inizia con R stringa .

!?stringa[?]

Designa il comando più recente che contiene R stringa . Il ? finale può essere omesso se stringa è seguita immediatamente da un codice di fine riga (newline).

^-2string1^-2string2^-2

Sostituzione rapida. Ripete l'ultimo comando, rimpiazzando stringa1 con R stringa2 . Equivalente a ``!!:s/stringa1/stringa2/'' (si veda Modificatori più avanti).

!#

L'intera riga di comando battuta fino a questo punto.

Designatori di parola¶

I designatori di parola sono usati per selezionare parole dall'evento. Un : separa la specificazione di evento dal designatore di parola. Esso può essere omesso se il designatore di parola inizia con un ^, $, *, - o %. Le parole sono numerate dall'inizio della riga, la prima parola essendo denotata da uno 0 (zero). Le parole sono inserite nella riga corrente separate da spazi singoli.

0 (zero)

La parola numero zero. Per la shell, questa è la parola che costituisce il nome del comando.

n

La n-esima parola.

^

Il primo argomento. Cioè, la parola 1.

$

L'ultimo argomento.

%

La parola che combacia con `?stringa?' nella più recente ricerca.

x-y

Un intervallo di parole; `-y' abbrevia `0-y'.

*

Tutte le parole tranne la numero zero. Questo è un sinonimo per `1-$'. Non è un errore usare * se vi è solo una parola nell'evento; in quel caso il risultato è una stringa vuota.

x*

Abbrevia x-$.

x-

Abbrevia x-$ come x*, ma omette l'ultima parola.

Se un designatore di parola è fornito senza una specificazione di evento, il comando precedente viene usato come evento.

Modificatori¶

Dopo l'opzionale designatore di parola, può comparire una sequenza di uno o più fra i seguenti modificatori, ognuno preceduto da un `:'.

h

Rimuove un componente finale in un nome di file, lasciando solo la testa.

r

Rimuove un suffisso finale della forma .xxx, lasciando il nome base (basename).

e

Rimuove tutto tranne il suffisso finale.

t

Rimuove tutti i componenti di testa in un percorso, lasciando la coda.

p

Stampa il nuovo comando ma non lo esegue.

q

Quota le parole sostituite, prevenendo ulteriori sostituzioni.

x

Quota le parole sostituite, come con q, ma spezza in parole sui blank e newline.

s/vecchio/nuovo/

Sostituisce nuovo alla prima occorrenza di vecchio nella riga di evento. Qualsiasi delimitatore può essere usato al posto di /. Il delimitatore finale è opzionale se esso è l'ultimo carattere della riga di evento. Il delimitatore può essere quotato in vecchio e nuovo con un singolo backslash. Se compare & in R nuovo , esso è sostituito da R vecchio . Un singolo backslash quota il carattere &. Se vecchio è nullo, viene impostato all'ultimo vecchio sostituito o, se nessuna sostituzione di cronologia è avvenuta, l'ultima stringa in una ricerca di !?stringa[?]

&

Ripete la precedente sostituzione.

g

Fa sì che i cambiamenti siano applicati sull'intera riga di evento. Questo si usa in congiunzione con `:s' (p.es., `:gs/vecchio/nuovo/') o `:&'. Se usato con `:s', qualsiasi delimitatore può essere usato al posto di /, e il delimitatore finale è opzionale se è l'ultimo carattere della riga di evento. Un a può essere usato come sinonimo di g.

G

Applica il modificatore che segue `s' una volta a ogni parola nella riga di evento.